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Important Information 

Texas Instruments makes no warranty, either expressed or implied, including but not limited 
to any implied warranties of merchantability and fitness for a particular purpose, regarding 
any programs or book materials and makes such materials available solely on an “as-is” 
basis. 

In no event shall Texas Instruments be liable to anyone for special, collateral, incidental, or 
consequential damages in connection with or arising out of the purchase or use of these 
materials, and the sole and exclusive liability of Texas Instruments, regardless of the form of 
action, shall not exceed the purchase price of this product. Moreover, Texas Instruments 
shall not be liable for any claim of any kind whatsoever against the use of these materials by 
any other party. 
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Overview System 

Routines 


Entry point 
name: 

The following is the format in which each of the entry points will appear. The 
entry points are listed alphabetically by category. 

Name used to identify the routine. 

Category: 

Description: 

Each entry point is identified by function into a category. 

Brief description of usage/purpose. How the routine works and additional 
information about the input. 

Inputs: 



Registers: Setup values in processor registers. 

Flags: Setup values in processor flags (F register). 

Others: OPX, stack or RAM locations initial conditions affecting results 

Outputs: 

Registers: Return information in processor registers. 

Flags: Return information in process flags. 


Others: 

Return information in OPX, stack, or RAM. 

Registers 

destroyed: 

RAM used: 

Processor registers whose initial values may be modified, so caller is 
responsible for preserving. 

RAM space needed, where applicable. 

Remarks: 

Description of appropriate usage context, limitations, and any other useful 
information, side effects, assumptions, etc. 

Example: 

An example of how to set up initial conditions and use the routine. 

NOTE () indicate indirection 
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System Routines — 
Display 


Bit_VertSplit 

CheckSplitFlag 

ClearRow 

ClrLCD 
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PutMap 

PutPS 

PutPS (continued ) .. 

PutPSB 

PutPSB (continued) 

Puts 

Puts (continued) 

PutTokString 

RestoreDisp 

RunlndicOff 

RunlndicOn 

SaveDisp 

SetNormVals 

SFont_Len 

SStringLength 

VPutMap 

VPutS 

VPutS (continued ) .. 

VPutSN 

VPutSN (continued) 
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Bit_VertSplit 


Category: 

Display 

Description: 

Inputs: 

Tests if the TI-83 Plus is set to G-T (graph-table) display mode. 

Registers: 

None 

Flags: 

None 

Others: 

None 

Outputs: 


Registers: 

None 

Flags: 

NZ = 1 if G-T mode is set 

Others: 

None 

Registers 

destroyed: 

None 

Remarks: 

Applications may want to reset the 83+ to full screen mode if graphing 
functionality is used. In G-T mode the screen is split vertically with 1/2 being 
the graph screen and the other the table display. 

Example: 

B_CALL Bit_VertSplit ; test for G-T mode 

JR NZ, Screen_is_Split ; jump if G-T mode 
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CheckSplitFlag 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Display 

Checks if either horizontal or G-T split screen modes are active. 


None 

grfSplitOverride, (IY + sGrFlags) = 1 to ignore split mode settings 

This flag is set to make system routines draw to the full screen even when in 

a split screen mode. 

None 


None 

Z = 1 if no split screen mode is active 
= 0 if a split screen mode is active 

None 

None 


B_CALL CheckSplitFlag 
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ClearRow 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Display 

Clears eight consecutive LCD display drive rows. 

A = LCD display driver row coordinate (0x80 - OxBF) 

None 

None 

None 

None 

Eight pixel rows cleared 
Driver left in X increment mode 


Registers A, B, DE 
destroyed: 

Remarks: This routine requires A to be in LCD display driver row (X) coordinates, 

which have a valid range between 0x80 - OxBF, with the top pixel row equal 
to 0x80 and the bottom pixel row equal to OxBF. Passing in a value for A 
outside this range will cause unpredictable results and probably a lockup. 
This routine erases eight consecutive rows, so if you pass in A = 0x88, the 
9th - 16th pixel rows from the top of the display are erased. If you pass in a 
value between 0xB9 - OxBF, the erased rows wrap back to the top of the 
display. In normal usage, if you are erasing a line of large text, the A value 
should be a multiple of 0x08. 

Example: 
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ClrLCD 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Display 

Clears the display. 


None 

G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. 

See ForceFullScreen. 

grfSplit, (IY + sGrFlags) = 1 if horizontal split mode set 
vertSplit, (IY + sGrFlags) = 1 if graph-table split mode set 
grfSplitOverride, (IY + sGrFlags) = 1 to ignore split modes 

None 


None 

None 

None 

All 

This routine only acts on the display, not the textShadow. 
Clear the display using the current split settings: 

B_CALL ClrLCD 
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ClrLCDFull 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Display 

Clears the display ignoring any split screen settings. 

None 

None 

None 

None 

None 

Entire display is cleared. 

All 


B_CALL ClrLCDFull 
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ClrOP2S 

Category: Display 

Description: Sets the floating-point number in OP2 to be positive. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

None 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B_CALL ClrOP2S 
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ClrScrn 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Display 

Clears the display. If textShadow is in use clears it also. 

None 

appTextSave,(IY + appFlags) = 1 if the textShadow is to be cleared also 

G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this turn off the split screen modes. 

See ForceFullScreen. 

grfSplit, (IY + sGrFlags) = 1 if horizontal split mode set 
vertSplit, (IY + sGrFlags) = 1 if graph-table split mode set 
grfSplitOverride, (IY + sGrFlags) = 1 to ignore split modes 
None 

None 

None 

Display and possibly textShadow cleared. 

All 


B_CALL ClrScrn 
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ClrScrnFull 


Category: Display 

Description: Clears the display entirely ignoring split screen settings. If textShadow \s in 

use clears it also. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


None 

appTextSave, (IY + appFlags) = 1 if the textShadow is to be cleared also 
None 

None 

None 

Display and possibly textShadow cleared. 

All 


B_CALL ClrScrnFull 
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ClrTxtShd 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Display 

Clears the textShadow buffer. 

None 

None 

None 


textShadow set to spaces. 

None 

None 

BC, DE, HL 


ClrScrn falls into this routine which zeros out 128 bytes starting at 
textShadow ( one byte for each 5x7 screen position (8 rows x16 columns)). 


Example: 
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DispDone 

Category: 
Description: 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 


Display 

Displays Done on text screen. 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


None 

None 

HL 


Example: 


B CALL 


DispDone 
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DispHL 


Category: 

Display 

Description: 

Inputs: 

Converts the contents of HL to a decimal and writes it to the screen at 
current cursor position. The string displayed is always 5 characters and right 
justified. The large 5x7 font is used. 

Registers: 

HL = two-byte value to convert 

Flags: 

None 

Others: 

Outputs: 

None 

Registers: 

None 

Flags: 

None 

Others: 

String displayed. (OP1) = start of five character decimal number string, right 
justified. 

Registers 

destroyed: 

AF, DE, HL 

Remarks: 

If the string does not fit on the current display row then it is truncated at the 
screen’s edge. 

Example: 

Set HL = 357 and display it starting in row 0 column 0. 

LD HL, 0 

LD (curRow) , HL ; set cursor position 

t 

LD HL, 357 

B_CALL DispHL 

RET 

what will be displayed is " 357", which has two leading spaces. 
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Displaylmage 

Category: Display 

Description: Displays a bitmap image stored in RAM 

Inputs: 

Registers: HL = pointer to image structure 

Height of image in pixels — one-byte 


Flags: 

Width of image in pixels — one-byte 

Image data by rows 

The first byte contains the data for the first eight-pixels of the first row. Bit 7 
is the left-most pixel of the first row. 

Each new row starts on a byte boundary. 

There may be unused bits in the last byte of each row if the image is not a 
multiple of eight in width. 

DE = location on screen to place the upper left corner of the image. 

(row, column) 

(0,0) = upper left corner of the screen. 

The image can be oriented off of the screen: ffh = -1 . The only restriction is 
that the image cannot be entirely off screen. 

plotLoc, (IY + plotFlags) = 1 if image drawn to display only. 

= 0 if image drawn to display and graph buffer. 

Others: 

bufferOnly, (IY + plotFlags) = 1 if image drawn to graph buffer only. 

This flag overrides the plotLoc flag. 

None 


Outputs: 

Registers: None 
Flags: None 


Others: 

Screen, graph buffer 

RAM locations @ ioPrompt - ioPrompt + 7 

Registers 

destroyed: 

All 

Remarks: 

(continued) 
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Displaylmage (continued) 

Example: Display an image three-pixels high by 17 pixels wide at position (0,0) to the 

display only. 


LD 

HL, ImageData 

; pointer to bitmap 

LD 

DE, OP1 


LD 

BC, 11 


LDIR 


; copy image data to 
; RAM 

LD 

HL, OP1 

; pointer to image 

LD 

DE, 0 

; position of upper 
; left corner 

SET 

plotLoc, ( IY+plotFlags ) 


B_CALL 

Displaylmage 



ImageData : 


DB 

3, 17 

; height, width 

DB 

8 Oh, 3eh, lOh 

; row 1, only bit 7 



; of the last byte 



; is used 

DB 

llh, 35h, Oh 

; row 2 

DB 

Of fh, Olh, lOh 

; row 3 
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DispOPI A 


Category: 

Description: 

Display 

Displays a floating-point number using either small variable width or large 
5x7 font. The value is rounded to the current “fix” setting (on the mode 
screen) before it is displayed. 


Inputs: 

Registers: ACC = maximum number of digits to format for displaying 
Flags: textlnverse, (IY + textFlags) = 1 for reverse video 


Others: 

textEraseBelow, (IY + textFlags) = 1 to erase line below character 
textWrite, (IY + sGrFlags) = 1 to write to graph buffer not display 
fracDrawLFont, (IY + fontFlags) = 1 to use large font, not small font 

(penCol) = pen column to display at 
(penFtow) = pen row to display at 


Outputs: 

Registers: None 
Flags: None 


Others: 

None 

Registers 

destroyed: 

RAM used: 

All 

OP1, OP2, OP3, OP4 

Remarks: 

Displaying stops if the right edge of the screen is reached. 

Example: 
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EraseEOL 


Category: Display 

Description: Erases screen to end of line. 

Inputs: 

Registers: None 
Flags: None 

Others: curRow, curCol point to screen position. 

Outputs: 

Registers: None 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


None 

None 

None, saves registers beforehand. 

curRow, curCol are also saved and restored. 

If the sEditRunning, (IY + apiFlg3) flag is set (sfont running). 

; curRow = 1, curCol = 


LD 

HL, 0801h 

LD 

(curRow) , HL 

LD 

A, 'H' 

B_CALL 

PutC 

LD 

A, ' I ' 

B_CALL 

PutC 

B_CALL 

EraseEOL 


clear to end of line 
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FormBase 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Ram Used: 


Display 

Converts a RealObj (single floating-point number) in OP1 into a displayable 
string. 

Use the current mode settings SCI, ENG, NORMAL and FIX setting to 
format the string. 

The output can also be formatted as a fraction or a Degrees, Minutes, 
Seconds (DMS) number. 


None 

To use the current format settings: 

(Flags + fmtFlags) copies to (Flags + fmtOverride) 

To override the current settings, modify the following flags: 

Resetting the next two flags sets NORMAL display mode. 
fmtExponent, (fmtOverride) = 1 for scientific display mode 
fmtEng, (fmtOverride) = 1 for engineering display mode 

Setting the next three flags will signify DMS formatting. 
fmtBin, (fmtOverride) 
fmtFlex, (fmtOverride) 
fmtOct, (fmtOverride) 

Setting the next two flags will signify Fraction formatting. 
fmtFlex, (fmtOverride) 
fmtOct, (fmtOverride) 

(fmtDigits) = OFFh for FLOAT, no fix setting 
= 0 - 9 if fix setting is specified 
OP1 = value to format. 


BC = length of string 
None 

String returned in RAM starting in OP3, and is 0 terminated 
All 

OP1 -OP6 


Remarks: If the current display mode settings are SCI or ENG, the output string will 

reflect the setting. The value is rounded based on the maximum width 
entered and the current fix setting. 

(continued) 


TI-83 Plus Developer Guide 


1-16 


Third Release January 25, 2002 


System Routines - Display 


FormBase (continued) 

Example: Generate a random number and display it at the current cursor position. Use 

all the current format settings except force SCI formatting. 


B_CALL 

Random 

; OP1 = random number 

LD 

A, ( IY+fmtFlags ) 

; get current format 
; settings 

RES 

fmtEng, A 


SET 

fmtExponent, A 

; override current and 
; set SCI formatting 

LD 

( IY+fmtOverride) ,A 

; set override flags 

B_CALL 

FormBase 

; generate the string 

LD 

HL, OP 3 

; start of string 

B_CALL 

Puts 

; display string 
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FormDCpIx 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 


Others: 


Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 


Display 

Converts a CpIxObj (pair of floating-point numbers) in OP1/OP2 into a 
displayable string. 

Use the current mode settings SCI, ENG, NORMAL, FIX setting, and 
complex number display format to format the string. 

The output can also be formatted as a fraction or a Degrees, Minutes, 
Seconds (DMS) number. 


None 

To use the current format settings: 

(Flags + fmtFlags) copies to (Flags + fmtOverride) 

To override the current settings, modify the following flags: 

Resetting the next two flags sets the NORMAL display mode. 
fmtExponent, (fmtOverride) = 1 for scientific display mode 
fmtEng, (fmtOverride) = 1 for engineering display mode 

These flags control the formatting of complex numbers. 
rectMode, (fmtOverride) = 1 for rectangular complex display 
fmtEng, (fmtOverride) = 1 for polar complex display 

Setting the next three flags will signify DMS formatting. 
fmtBin, (fmtOverride) 
fmtHex, (fmtOverride) 
fmtOct, (fmtOverride) 

Setting the next two flags will signify Fraction formatting. 
fmtPlex, (fmtOverride) 
fmtOct, (fmtOverride) 

(fmtDigits) = OFFh for FLOAT, no fix setting 
= 0 - 9 if fix setting is specified 

OP1 = value to format 


BC = length of string 
None 

String returned in RAM starting in (fmtString), and is 0 terminated. 
All 

OP1 -OP6 


(continued) 


TI-83 Plus Developer Guide 


1-18 


Third Release January 25, 2002 


System Routines - Display 


FormDCpIx (continued) 

Remarks: If the current display mode settings are SCI or ENG, the output string will 

reflect the setting. The value is rounded based on the maximum width 
entered and the current fix setting. 

Example: Generate a random complex number and display it at the current cursor 

position. Use all the current format settings except force SCI formatting. 


B_CALL 

Random 

; OP1 = random number 

RST 

rPushRealOl 

; save 

B_CALL 

Random 

; OP1 = random number 

B_CALL 

PopReal02 

; OP 2 = 2nd part of 
; floating-point number 

LD 

A, ( IY+fmtFlags ) 

; get current format 
; settings 

RES 

fmtEng, A 


SET 

FmtExponent, A 

; override current and 
; set SCI formatting 

LD 

( IY+fmtOverride) ,A 

; set override flags 

B_CALL 

FormDCpIx 

; generate the string 

LD 

HL, fmtString 

; start of string 

B_CALL 

Puts 

; display string 
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FormEReal 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 


Example: 


Display 

Converts a RealObj (single floating-point number) in OP1 into a displayable 
string. 

This routine will ignore all format settings. 

Specify the maximum width allowed for the string generated. 

ACC = maximum width of output, minimum of six 
None 

OP1 = value to format 


BC = length of string 
None 

String returned in RAM starting in OP3, and is 0 terminated. 

All 

OP1 - OP6 

If the current display mode settings are SCI or ENG, the output string will 
reflect the setting. The value is rounded based on the maximum width 
entered and the current fix setting. 

Generate a random number and display it with a maximum of six characters 
at the current cursor position. Ignore all format settings when generating the 
string to display. 


B_CALL 

Random 

; OP1 = random number 

LD 

A, 6 

; max width to format 

B_CALL 

FormEReal 

; generate the string 

LD 

HL, OP 3 

; start of string 

B_CALL 

Puts 

; display string 
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FormReal 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 


Others: 


Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 


Example: 


Display 

Converts a RealObj (single floating-point number) in OP1 into a displayable 
string. 

Specify the maximum width allowed for the string generated. 


ACC = maximum width of output, minimum of six 

fmtExponent, (fmtFlags) = 1 for scientific display mode 
fmtEng, (fmtFlags) = 1 for engineering display mode 

If both of the above flags are reset, then NORMAL display mode. 

(fmtDigits) = OFFh for FLOAT, no fix setting 
= 0 - 9 if fix setting is specified 

OP1 = value to format 


BC = length of string 
None 

String returned in RAM starting in OP3, and is 0 terminated. 

All 

OP1 - OP6 

If the current display mode settings are SCI or ENG, the output string will 
reflect the setting. The value is rounded based on the maximum width 
entered and the current fix setting. 

Generate a random number and display it with a maximum of six characters 
at the current cursor position. 


B_CALL 

Random 

; OP1 = random number 

LD 

A, 6 

; max width to format 

B_CALL 

FormReal 

; generate the string 

LD 

HL, OP 3 

; start of string 

B_CALL 

Puts 

; display string 
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Load Pattern 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Display 

Loads the font pattern for a character to RAM. Also includes the characters 
width in pixels. This will work for both variable width and 5x7 fonts. 

ACC = character equate 

fracDrawLFont, (IY + fontFlags) = 1 to use Large 5x7 font 

= 0 to use variable width font 


None 


None 

None 

For large 5x7 font: RAM @ IFont_record = width of character, seven-byte 
font 

For variable width font: RAM @ sFont_record = width of character, seven- 
byte font 

The first byte of the font is the pixel mapping for the top row and each 
subsequent byte is the next row. 

The LSB of each byte represents the right most pixel of a row. 

All 


If fracDrawLFont is set, it must be reset. 
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Load SFont 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Display 

Copies small font attributes to RAM for a particular display character. 

HL = offset into small font table 

None 

None 

HL = pointer to sFont_record RAM 
None 

sFont_record...sFont_record + 7 = font 
DE, HL 

This might be useful, if you wish to write your own LoadPattern or VPutMap 
routine for displaying small display characters. The system character fonts 
(large and small) use eight-bytes per character. 

To convert a character number to a table offset, multiply the number by 
eight. 

Find the width of the small display character f: 


LD 

A, 'F ' 


LD 

L, A 


LD 

H, 0 


ADD 

HL, HL 

; * 2 turn character into an 

; offset. 

ADD 

HL, HL 

; * 4 

ADD 

HL, HL 

; * 8 multiply by 8 to get 
; table offset. 

B_CALL 

Load_SFont 

; sFont_record = 

; 03,00,02,04,06,04,04,00 

LD 

A, (HL) 

; 1st byte is width 
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NewLine 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Display 

Move cursor to beginning of next line and scroll the display if necessary. 

None 

appAutoScroll, (lY+appFlags) = 1 to automatically scroll display 
None 


None 

textScrolled, (lY+textFlags) = 1 if display scrolled 
(curFtow) is incremented if display does not scroll. 
(curCol) = 0. 

All 


Presumes that (winTop) has been previously initialized to the top of the 
window and (winBtm) has been initialized to the bottom of the window, (eg., 
usually winBtm = 8 and winTop = 0. In horizontal split screen, winTop = 4). 

Reset the appAutoScroll (lY+appFlags) flag to avoid scrolling the screen if 
on the bottom line. But if doing so, curRow may be incremented to an 
invalid state (eg, row 8 or above), so this condition needs to be checked and 
curRow re-initialized if you use this flag. 
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OutputExpr 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 


Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

Remarks: 


Example: 


Display 

Converts a numeric value, string or equation, into a string and displays it 
using the large 5x7 font. This routine should be used with the split screen 
setting to set to FullScreen. 


H = column number to display at: e.g., 0...15 
L = row number to display at: e.g., 0...7 

textlnverse, (IY + textFlags) = 1 to display in reverse video 
appTextSave, (IY + appFlags) = 1 to write character to textShadow also 

OP1/OP2 = what to display: 

Floating-point number in OP1 
Complex number in OP1/OP2 

A variable name in OP1 of type: complex, list (real/complex), matrix, 
string, equation. 


None 

None 

System errors can be generated, See the Error Plandlers section in Chapter 
2 . 

String output to display. 

All 

Previous cursor setting is restored to curRow and curCol. Output will wrap to 
next line if complete string does not fit on a single line. Output will stop at 
bottom of screen. 

Output the contents of matrix variable [A] at cursor location row 2, column 3. 


LD 

HL, matAname 


RST 

rMov9ToOP 1 

; OP1 = matrix [A] name 

AppOnErr 

Catch_Error 

; install error handler 

LD 

HL, 3*256+2 

; row 2 column 3 

B_CALL 

OutputExpr 


AppOf f Err 



RET 
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PutC 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Display 

Displays a character and advance cursor. 

A = character to display 

textlnverse, (lY+textFlags): 0 = normal character; 1 = invert character 
curRow, curCol = display row and column values 


None 

None 

curRow, curCol Updated 
None 


This routine calls PutMap to do the character display. 

This may cause a screen scroll if on the bottom line. 

; curRow = 1, curCol 


LD 

LD 

LD 

B_CALL 

LD 

B CALL 


HL, 0801h 
(curRow) , HL 

A, "H" 

PutC 

A, "I" 

PutC 


; (Puts might be more useful for multiple characters) 
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PutMap 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Display 

Displays a character in the large font without affecting cursor position. 


ACC = character to display, see TI83plus.inc 

textlnverse, (IY + textFlags) = 1 to display in reverse video 
appTextSave, (IY + appFlags) = 1 to write char to textShadow also 
preCIrForMode, (IY + newDispF) = 1 to preclear the character space before 

writing 

This is done when toggling between inverted and uninverted. 

(curRow) = home screen row to display in, 0-7 
(curCol) = home screen column to display in, 0-15 


None 

None 

None 

None 


See: PutC. 

Display char C in row 3 column 4: 


LD 

HL, 4*256+3 


LD 

(curRow) , HL 

; set curRow & curCol 

LD 

A, 'C' 


B_CALL 

PutMap 
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PutPS 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Display 

Displays a string with a leading length byte residing in RAM, at the current 
cursor position, and stops at the bottom of the display. This routine uses the 
large 5x7 font. 


HL = pointer to length byte of string followed by the string 

textlnverse, (IY + textFlags) = 1 to display in reverse video 

appAutoScroll, (IY + appFlags) = 1 to scroll if need to display past the 

bottom of the display. 

appTextSave, (IY + appFlags) = 1 to write character to textShadow also. 

preCIrForMode, (IY + newDispF) = 1 to preclear the character space before 

writing. This is done when toggling 
between inverted and noninverted. 

(curRow) = cursor row position, (0 - 7) 

(curCol) = cursor column position, (0-15) 


None 

Carry = 1 if entire string was displayed 
Carry = 0 if string did not fit in the display 

curRow and curCol are updated to the position after the last character 
displayed. 

All but DE 


It is recommended that this routine be placed in-line so that strings can be 
displayed from an application without copying them to RAM first. See the 
Display Routines section in Chapter 2 for further information. 

(continued) 
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PutPS (continued) 

Example: PutPS: 



LD 

A, (HL) 

; A = length of string 


INC 

HL 



OR 

A 



RET 

Z 

; IF LENGTH IS 0 RET 

PutPSlO : 

LD 

A, (HL) 

; get a character of string name 


INC 

HL 


PutPS20 : 

B_CALL 

PutC 

; display one character of string 

PutPS30 : 

LD 

A, (curRow) 



LD 

C, A 



LD 

A, (winBtm) 



CP 

C 

; IS CURSOR OFF SCREEN ? 


RET 

z 

; RET IF YES 

r 

DJNZ 

PutPSlO 

; display rest of string 


RET 
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PutPSB 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Display 

Displays a string with a leading length byte residing in RAM, at the current 
cursor position, and stops at the right edge of the display. Ignores leading 
spaces. This routine uses the large 5x7 font. 


HL = pointer to length byte of string followed by the string 

textlnverse, (IY + textFlags) = 1 to display in reverse video 

appTextSave, (IY + appFlags) = 1 to write character to textShadow also. 

preCIrForMode, (IY + newDispF) = 1 to preclear the character space before 

writing. This is done when toggling 
between inverted and noninverted. 

(curRow) = cursor row position, (0 - 7) 

(curCol) = cursor column position, (0-15) 


None 

Carry = 1 if entire string was displayed 
Carry = 0 if string did not fit in the display 

curRow and curCol are updated to the position after the last character 
displayed. 

All but DE 


It is recommended that this routine be placed in-line so that strings can be 
displayed from an application without copying them to RAM first. See the 
Display Routines section in Chapter 2 for further information. 

(continued) 
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PutPSB (continued) 

Example: PutPSB: 



LD 

A, (HL) 

; A = length of string 


LD 

B, A 



INC 

HL 



OR 

A 



RET 

Z 

; IF LENGTH IS 0 RET 


LD 

A, (HL) 



CP 

> > 



JR 

Z, PutPSB30 



JR 

PutPSB20 


PutPSBIO : 

LD 

A, (curCol) 

; get column to print string 


CP 

15 

; last column? 


JR 

C, PutPSB15 

; no, do regular PutC 


LD 

A, (HL) 

; get a character of string name 


B_CALL 

PutMap 

; output character without newline 


JR 

PutPSB30 


PutPSB15 : 

LD 

A, (HL) 

; get a character of the string 

PutPSB20 : 

B_CALL 

PutC 

; display one character of string 

PutPSB30 : 

INC 

HL 



DJNZ 

PutPSBIO 

; display rest of string 


RET 
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Puts 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Display 

Displays a zero (0) terminated string residing in RAM at the current cursor 
position. This routine uses the large 5x7 font. 


HL = pointer to start of string 

textlnverse, (IY + textFlags) = 1 to display in reverse video 

appAutoScroll, (IY + appFlags) = 1 to scroll if need to display past the 

bottom of the display. 

appTextSave, (IY + appFlags) = 1 to write character to textShadow also. 

preCIrForMode, (IY + newDispF) = 1 to preclear the character space before 

writing. This is done when toggling 
between inverted and noninverted. 

(curRow) = cursor row position, (0 - 7) 

(curCol) = cursor column position, (0-15) 


None 

Carry = 1 if entire string was displayed 
Carry = 0 if string did not fit in the display 

curRow and curCol are updated to the position after the last character 
displayed. 

HL 


To avoid having to copy strings from an application to RAM before using this 
routine, it is much more efficient to place this routine inside of the 
application. By doing so, the application can display strings without first 
having to copy to RAM. 

(continued) 
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Puts (continued) 

Example: Puts: 


PutSlO : 


PutS20 : 


PUSH 

BC 


PUSH 

AF 


LD 

A, (winBtm) 


LD 

B, A 

; B = bottom line of window 

LD 

A, (HL) 

; get a character of string name 

INC 

HL 


OR 

A 

; end of string? 

SCF 


; indicate entire string was 
; displayed 

JR 

Z, PutS20 

; yes > 

B_CALL 

PutC 

; display one character of string 

LD 

A, (curRow) 

; check cursor position 

CP 

B 

; off end of window? 

JR 

C, PutSlO 

; no, display rest of string 

POP 

BC 

; restore A (but not F) 

LD 

A, B 


POP 

RET 

BC 

; restore BC 
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PutTokString 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Display 

Displays the string for a token at the current cursor location. 

DE = token value. If a one-byte token then D = 0, E = token. 
None 

(curRow) = home screen row to display in, 0 - 7 
(curCol) = home screen column to display in, 0 - 5 

None 

None 

String displayed with wrapping. 

All 


Display the string for the Sin( token at the current cursor location: 


LD 

D 

o 


LD 

E, tSin 

; DE = token 

B_CALL 

PutTokString 

; get its string and display 

; it . 
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RestoreDisp 


Category: Display 

Description: Displays one to 64 rows of the display starting with the top row. 

Inputs: 

Registers: HL = pointer to ROM/RAM of the data for the first row to display, from left to 
right. This is followed by the remaining row’s data. Each row is stored 
in 12-bytes, the first column is bit seven of the first byte for each row. 

B = number of pixel rows to be displayed 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: Data written to the display. 

Interrupts are disabled, turn them back on if needed. 


Registers All 

destroyed: 

RAM used: curXRow — 1 byte 

Remarks: 

Example: Copy the first 1 0 lines of the graph buffer to the display. 


LD 

HL, plotSScreen 

; start of buffer 

LD 

B, 10 

; 10 rows to display 

B_CALL 

RestoreDisp 


El 


; re-enable interrupts 
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RunlndicOff 

Category: Display 

Description: Turns off run indicator. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: indicRun, (lY+indicFlags) = 0 

Others: None 

Registers Flag register 
destroyed: 


Remarks: 

Example: b_call Runindicoff 
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RunlndicOn 

Category: Display 

Description: Turns on run indicator. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: indicRun, (lY+indicFlags) = 1 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B_CALL RunlndicOn 
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SaveDisp 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Display 

Copies a bit image of the current display to RAM. 

HL = pointer to RAM location to save the image — the bit image of the 
display is 768 bytes in size. 

None 

None 

None 

None 

Contents of display written to RAM. Interrupts are disabled. 

All 

curXRow 

Split screen modes are ignored, the entire display is copied. 

Copy the current display to the graph backup buffer, plotSScreen. 

LD HL, plotSScreen 

B_CALL SaveDisp 

RET 
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SetNorm 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Vais 

Display 

Sets display attributes to full screen mode. 

None 

None 

None 


None 

None 

Display attributes set to full screen. Allows for full screen drawing and text 
displaying. 

All 


This routine should only be used in combination with the setting of 
appropriate system flags that control the screen split settings. See the 
Display and Split Screen Modes sections in Chapter 2 for further 
information. 
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SFont Len 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Display 

Returns the width, in pixels, a character would use if displayed using the 
small variable width font. 


HL = offset into the font look-up table. This is generated by multiplying the 
character equate of a character by eight. 

None 

None 


ACC = number of pixels needed to display the character using the small 
font. 

None 

None 

All B 


Return the width in pixels of the small font character: 

LD HL, Scolon*8 ; compute offset 

B_CALL SFont_Len 
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SStringLength 

Category: Display 

Description: Returns the width in pixels a string would use if displayed using the small 

variable width font. 

Inputs: 

Registers: HL = pointer to the string, with the first byte being the number of characters 
in the string. The string must reside in RAM. 

Flags: None 

Others: None 

Outputs: 

Registers: ACC and B = number of pixels needed to display the string using the small 
font. 


Flags: 

None 

Others: 

None 

Registers 

destroyed: 

Remarks: 

Example: 

All but HL 
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VPutMap 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Display 

Displays a character at the current pen location. Uses either the variable 
width font or the large 5x7 font. 

The advantage to displaying the large font with this routine instead of the 
PutC routine is the character can be placed at any location on the screen. 
With PutC routine, the characters can only be displayed in the 8 row by 16 
column grid specified by (curRow) and (curCol). 


ACC = character to display 

textlnverse, (IY + textFlags) = 1 for reverse video 

textEraseBelow, (IY + textFlags) = 1 to erase line below character applies to 

variable width font only 

textWrite, (IY + sGrFlags) = 1 to write to graph buffer instead of the display 
fracDrawLFont, (IY + fontFlags) = 1 to use large font, not small font 

(penCol) = pen column to display at 
(penRow) = pen row to display at 


None 

None 

CA (carry) = 1 if could not fit in screen 
All but BC and HL 


Pen location (0,0) is the upper left corner of the display. 

The formatting flags are normally reset. An application should make sure 
that these flags are managed properly during execution and reset before 
returning to normal system operation. 

Draw the character C at pen location (0,0): 

LD HL, 0 

LD (penCol),HL ; set penRow and penCol 

LD A, ' C ' 

B_CALL VPutMap 
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VPutS 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Display 

Displays a zero (0) terminated string at the current pen location. Uses either 
the variable width font or the large 5x7 font. 

The advantage to displaying the large font with this routine instead of the 
Puts routine is the string can be placed at any location on the screen. With 
the Puts routine, the string can only be displayed in the 8 row by 16 column 
grid specified by (curRow) and (curCol). 


RAM. 


HL = pointer to 0 terminated string in 

textlnverse, (IY + textFlags) 
textEraseBelow, (IY + textFlags) = 
textWrite, (IY + sGrFlags) 
fracDrawLFont, (IY + fontFlags) = 


1 for reverse video 
1 to erase line below character 
1 to write to graph buffer not display 
1 use 5x7 font 

0 use variable width font (default) 


(penCol) = pen column to display at 
(penRow) = pen row to display at 


None 

None 

CA = 1 if could not tit on the row of the screen entirely 
HL 


Pen location (0,0) is the upper left corner of the display. If fracDrawLFont is 
set, it must be reset. It is recommended that the following routine be placed 
in-line so that strings can be displayed from an application without copying 
them to RAM first. See the Display Routines section in Chapter 2 for further 
information. 


(continued) 
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VPutS (continued) 


Example: 


VPutS : 


VPutSlO : 


VputS20 : 


PUSH 

AF 



PUSH 

DE 



PUSH 

IX 



LD 

A, (HL) 

; get a character 

of string name 

INC 

HL 



OR 

A 

; end of string? 


JR 

Z, VputS20 

; yes > 


B_CALL 

VPutMap 

; display one character of string 

JR 

NC, VPutSlO 

; display rest of 

string IF FITS 

POP 

IX 



POP 

DE 



POP 

AF 



RET 





Display Hello world in variable width font at the current pen location. 


Hellostr : 


LD 

HL, Hellostr 

LD 

DE, OP1 

LD 

BC, 14 

LDIR 


LD 

HL, OP1 

B_CALL 

VPutS 

RET 



DB "Hello World", 0 


copy string to RAM 


TI-83 Plus Developer Guide 


1-44 


Third Release January 25, 2002 


System Routines - Display 


VPutSN 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Display 

Displays a string of known length at the current pen location. Uses either the 
variable width font or the large 5x7 font. 

The advantage to displaying the large font with this routine instead of the 
Puts routine, is the string can be placed at any location on the screen. With 
the Puts routine, the string can only be displayed in the 8 row by 16 column 
grid specified by (curRow) and (curCol). 


HL = pointer to first character of string in RAM 


B = number of characters to display 

textlnverse, (IY + textFlags) 
textEraseBelow, (IY + textFlags) = 
textWrite, (IY + sGrFlags) 
fracDrawLFont, (IY + fontFlags) = 


1 for reverse video 
1 to erase line below character 
1 to write to graph buffer not display 
1 use 5x7 font 

0 use variable width font (default) 


(penCol) = pen column to display at 
(penRow) = pen row to display at 


None 

None 

CA = 1 if could not fit on the row of the screen entirely 
HL 


Pen location (0,0) is the upper left corner of the display. If fracDrawLFont is 
set, it must be reset. It is recommended that the following routine be placed 
in-line so that strings can be displayed from an application without copying 
them to RAM first. See the Display Routines section in Chapter 2 for further 
information. 


(continued) 
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VPutSN (continued) 


Example: 


VPutSN: 


PUSH 

AF 




PUSH 

DE 




PUSH 

IX 




LD 

A, (HL) 

; get a character 

of string name 

INC 

HL 




B_CALL 

VPutMap 

; display 

one character of string 

JR 

C, PP11 

; JUMP IF 

NO ROOM 

ON LINE 

DJNZ 

PP10 

; display 

rest of 

string 

POP 

IX 




POP 

DE 




POP 

AF 




RET 






Display Hello world in variable width font at the current pen location. 


LD 

HL, Hellostr 


LD 

DE, OP1 


LD 

BC, 14 


LDIR 


; copy string to RAM 

LD 

HL, OP1 


LD 

B, 11 

; length of string 

B_CALL 

VPutSN 


RET 




Hellostr : 

DB "Hello World" 
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System Routines — 

Edit 


CloseEditBuf 

CloseEditBufNoR 

CloseEditEqu 

CursorOff 

CursorOn 

DispEOL 

IsEditEmpty 

KeyToString 

ReleaseBuffer 
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CloseEditBuf 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Edit 

Close and deletes edit buffer without parsing. 

None 

editOpen, (IY + editFlags) set if open 
None 

None 

None 

Adjusts free RAM pointers 
All 

See CloseEditBufNoR for example. 
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CloseEditBufNoR 


Category: Edit 

Description: Closes edit buffer, but does not delete it. 

Inputs: 

Registers: None 

Flags: editOpen, (IY + editFlags) set if open 

Others: None 

Outputs: 

Registers: None 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


None 

Adjusts free RAM pointers 
All 

An edit session allocates all available RAM, but generally only a portion of that 
RAM is actually used. 

This routine is used to free up any extra RAM after an edit is finished and 
before the parser is invoked to evaluate the input. 

Same as: 




B_CALL 

CanAlphlns 

; cancel alpha and insert 
; mode 



B_CALL 

CloseEditEqu 

; return edit buffer to 





; user memory 



RET 



Example: 

r 

B_CALL 

IsEditEmpty 

; is edit buffer empty? 



JR 

NZ, NotEmpty 

; no 



B_CALL 

CloseEditBuf 

; close & delete buffer 
; without parsing 



RET 




NotEmpty : 

B_CALL 

CloseEditBufNoR 

; close but do not delete 



CALL 

At Name 

; Name of edit buffer 



B_CALL 

Parselnp 

; parse, result -> OP1 
; store result 



B_CALL 

ReleaseBuf fer 

; throw away edit buffer. 



RET 




At Name : 

LD 

HL, 




LD 

A, EquObj 




LD 

(OP1), A 




LD 

(OP1+1) , HL 




XOR 

A 




LD 

(OP1+3 ) , A 




RET 
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CloseEditEqu 

Category: Edit 

Description: Returns any unused portion of an edit buffer to memory. 

Inputs: 

Registers: None 

Flags: editOpen,(IY+editFlags) = 1 if edit buffer is open 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Adjusts free RAM pointers. 

Registers 

destroyed: 

All 

Remarks: 

See also: CloseEditBufNoR 


TI-83 Plus Developer Guide 


2-3 


Third Release January 25, 2002 


System Routines — Edit 


CursorOff 

Category: Edit 

Description: Turns off the cursor if it is turned on and disable blinking 

Inputs: 

Registers: None 

Flags: curOn, (IY + curFlags) = 1 if cursor is currently on. 


Others: 

appCurGraphic, (IY + appFlags) = 1 if the graphic cursor 

This mode should not be set by an application. 

appCurWord, (IY + appFlags) = 1 if a full word cursor 

This mode should not be set by an application. 

If a normal edit cursor: 

(curFtow), (curCol) = cursor location 
(curUnder) = character the cursor is covering 

If a graphic cursor: 

(curGX), (curGY) = center pixel location of cursor 
(curGStyle) = which graph cursor is active 

If a full word cursor: 

These are specific to the current context and entries are made in-line in the 
cursor blink routine. 


Outputs: 

Registers: None 

Flags: curOn, (IY + curFlags) = is reset 


Others: 

curAble, (IY + curFlags) = is reset to disable future blinking 

None 

Registers 

destroyed: 

Remarks: 

All 

Example: 



TI-83 Plus Developer Guide 


2-4 


Third Release January 25, 2002 


System Routines — Edit 


CursorOn 

Category: Edit 

Description: Enables cursor blinking and show the cursor. 

Inputs: 

Registers: None 

Flags: curLock, (IY + curFlags) = 1 if cursor is locked disabled, the cursor 


Others: 

cannot be turned on to blink. 

appCurGraphic, (IY + appFlags) = 1 if the graphic cursor 

This mode should not be set by an application. 

appCurWord, (IY + appFlags) = 1 if a full word cursor 

This mode should not be set by an application. 

If a normal edit cursor: 

(curFtow), (curCol) = cursor location 

If a graphic cursor: 

(curGX), (curGY) = center pixel location of cursor 
(curGStyle) = which graph cursor is active 

If a full word cursor: 

These are specific to the current context and entries are made in-line in the 
cursor blink routine. 


Outputs: 

Registers: None 

Flags: curOn, (IY + curFlags) = is set 


Others: 

curAble, (IY + curFlags) = is set to enable future blinking 

(curUnder) = character the cursor is covering 

Registers 

destroyed: 

Remarks: 

All 

Example: 
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System Routines — Edit 


DispEOL 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Edit 

Displays edit buffer to End of Line. 

None 

None 

editBuffer pointers 


Display modified 

None 

None 

AF, BC, DE, HL 


Displays buffer from editT ail to editBtm or until the end of the line is reached. If 
the buffer is finished before reaching the end of line, then EraseEOL is called 
to erase to the end of the line. Current curCol value is saved and restored by 
this routine; it is not modified. Since this routine only displays to the end of the 
current line, curRow is not modified. 
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System Routines — Edit 


IsEditEmpty 


Category: Edit 

Description: Tests if the Edit Buffer is empty. This is accomplished by confirming (editT ail) 

equals (editBtm) AND (editCursor) equals (editTop). 


Inputs: 

Registers: None 
Flags: None 

Others: editTop, editCursor, editTail and editBtm pointer values must be valid - the edit 

session must be active. 


Outputs: 

Registers: None 

Flags: Z = 1 (edit buffer is empty) 

= 0 (edit buffer is not empty) 


Others: None 

Registers A, DE, HL 

destroyed: 


Remarks: This module is essentially a B Call to isAtBtm followed by a B Call to 

isAtTop. 

Refer to isAtTop, isAtBtm modules for additional operational details. 

Example: 
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System Routines — Edit 


KeyToString 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Edit 

Converts key to a string value. 
DE = key 

D = 0 if a one-byte key 

None 

None 


HL = keyToStrRam (keyForStr + 1) 
None 

keyForStr initialized to string 
AF, BC, DE, HL 


Keys are converted to tokens (if possible) and the token string copied to the 
keyForStr RAM area (18 bytes). 

HL points to the length byte of the string (in keyToStrRam). 

See TI83plus.inc for key and token values. 

To display the string for the Continue key: 


LD 

D 

o 

; "Continue" is a one byte key, 

; so set to 0. 

LD 

E, kCont 

; "Continue" 

B_CALL 

KeyToString 

; convert to string: HL points 
; to keyToStrRam. 

B_CALL 

PutPSB 

; display string preceded by a 
; length byte . . . 

B_CALL 

EraseEOL 

; erase the rest of the line if 
; need be . 


keyToStrRam would appear as follows: 

08h, 43h, 6Fh, 6Eh, 74h, 69h, 6Eh, 75h, 65h 

(Length of string is eight bytes, followed by the ASCII characters Continue.) 
See TI83plus.inc or Appendix B for the TI-83 Plus character set values. 
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System Routines — Edit 


ReleaseBuffer 

Category: Edit 

Description: Deletes numeric edit buffer. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 

Others: None 


Registers All 
destroyed: 

Remarks: After evaluation and an edit buffer is no longer needed, it is important to delete 

that buffer so that it doesn’t take up unnecessary RAM. 

This routine can be included as part of an evaluation routine (if the buffer does 
not need to be redisplayed or edited), or as part of a putaway routine as you 
are leaving a context and returning back to the system. 

See CloseEditBufNoR for example. 

Example: 
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System Routines — 
Error 


ErrArgument 

ErrBadGuess 

ErrBreak 

ErrD_OP1_0 

ErrD_OP1_LE_0 

ErrDOPI Not_R 

ErrDOPI NotPos ... 
ErrD_OP1 NotPosInt 

ErrDataType 

ErrDimension 

ErrDimMismatch 

ErrDivByO 

ErrDomain 

Errlncrement 

Errlnvalid 

Errlterations 

ErrLinkXmit 

ErrMemory 

ErrNonReal 

ErrNonReal 

ErrNotEnoughMem . 

ErrOverflow 

ErrSignChange 

ErrSingularMat 

ErrStat 

ErrStatPlot 

ErrSyntax 

ErrTolTooSmall 

ErrUndefined 

JError 

JErrorNo 


3-1 

3-2 

3-3 

3d 

3^5 

3^6 

3^7 

3^8 


3-9 


3-10 

3-11 

3-12 

3-13 

3-14 

3-15 

3-16 

3-17 

3-18 

3-19 

3-20 

3-21 

3-22 

3-23 

3-24 

3-25 

3-26 

3-27 

3-28 

3-29 

3-30 

3-31 
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System Routines - Error 


ErrArgument 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: ARGUMENT. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B JUMP ErrArgument 
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System Routines — Error 


ErrBadGuess 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Error 

Jumps to system error handler routine with the message ERR: BAD GUESS. 

None 

None 

None 

None 

None 

None 


B JUMP ErrBadGuess 
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System Routines — Error 


ErrBreak 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: BREAK. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B JUMP ErrBreak 
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System Routines — Error 


ErrD OP1 0 


Category: Error 

Description: If OP1 = 0.0, domain error system will take over with message ERR: DOMAIN. 

Inputs: 

Registers: None 

Flags: None 

Others: None 

Outputs: 

Registers: None 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


None 

None 

A 


B JUMP 


ErrD OP1 0 
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System Routines — Error 


ErrD OP1 LE 0 


Category: Error 

Description: If OP1 0 (not positive), domain error system will take over with message 

ERR: DOMAIN. 


Inputs: 

Registers: None 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers A 
destroyed: 

Remarks: 

Example: b_jump 


ErrD_OPl_LE_0 
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System Routines — Error 


ErrD OPINot R 


Category: Error 

Description: If OP1 is not real, domain error system will take over with message 

ERR: DOMAIN. 


Inputs: 

Registers: None 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers A 
destroyed: 

Remarks: 

Example: b_jump 


ErrD_OPlNot_R 
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System Routines — Error 


ErrD OPINotPos 


Category: Error 

Description: If OP1 is not positive, domain error system will take over with message 

ERR: DOMAIN. 


Inputs: 

Registers: None 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers A 
destroyed: 

Remarks: 

Example: b_jump 


ErrD_OPlNotPos 
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System Routines — Error 


ErrD OPINotPosInt 


Category: Error 

Description: If OP1 is not positive integer, domain error system will take over with message 

ERR: DOMAIN. 


Inputs: 

Registers: None 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers A 
destroyed: 

Remarks: 

Example: b_jump 


Er rD_OP INotPos Int 


TI-83 Plus Developer Guide 


3-8 


Third Release January 25, 2002 


System Routines — Error 


ErrDataType 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: DATA TYPE 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B JUMP ErrDataType 
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System Routines — Error 


ErrDimension 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: INVALID DIM 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B_JUMP ErrDimension 
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System Routines — Error 


ErrDimMismatch 


Category: Error 

Description: Jumps to system error handler routine with the message ERR: DIM 

MISMATCH. 


Inputs: 

Registers: None 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 

destroyed: 

Remarks: 

Example: b_jump 


ErrDimMismatch 
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System Routines — Error 


ErrDivByO 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: DIVIDE BY 0 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B JUMP ErrDivByO 
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System Routines — Error 


ErrDomain 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: DOMAIN 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B_JUMP ErrDomain 


TI-83 Plus Developer Guide 


3-13 


Third Release January 25, 2002 


System Routines — Error 


Errlncrement 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: INCREMENT. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B_JUMP Errlncrement 
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System Routines — Error 


Errlnvalid 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: INVALID 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B JUMP Errlnvalid 
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System Routines — Error 


Errlterations 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: ITERATIONS. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B_JUMP Errlterations 
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System Routines — Error 


ErrLinkXmit 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: IN XMIT. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B JUMP ErrLinkXmit 
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System Routines — Error 


ErrMemory 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: MEMORY. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B_JUMP ErrMemory 
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System Routines — Error 


ErrNon Real 


Category: Error 

Description: In Real mode, the result of a calculation yielded a complex result. This error is 

not returned during graphing. The TI-83 Plus allows for undefined values on a 
graph. 


inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


None 

None 

None 

None 

None 

None 


The error system will take over and report the error to the screen. Any 
application that was executing at that time will be aborted. 


Example: 


B JUMP ErrNon_Real 
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System Routines — Error 


ErrNonReal 


Category: Error 

Description: Errors if nonreal input to command error. System will take over with message 

ERR: DATA TYPE. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


B = number of arguments to check. 
None 

Arguments on Floating Point Stack. 

None 

None 

Error if nonreal input to command. 
Screen will have data type error menu. 

A, B 


B JUMP ErrNonReal 
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System Routines — Error 


ErrNotEnoughMem 

Category: Error 

Description: If not enough memory, memory error system will take over with message 

ERR: MEMORY. 

Inputs: 

Registers: HL = number of bytes needed. 

Flags: None 

Others: None 

Outputs: 

Registers: DE = Amount of memory requested. 

Flags: CA = 1 if not enough room. 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B_JUMP ErrNotEnoughMem 


TI-83 Plus Developer Guide 


3-21 


Third Release January 25, 2002 


System Routines — Error 


ErrOverflow 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: OVERFLOW. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B JUMP ErrOverflow 
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System Routines — Error 


ErrSignChange 


Category: Error 

Description: Jumps to system error handler routine with the message ERR: NO SIGN 

CHANGE. 


Inputs: 

Registers: None 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 

destroyed: 

Remarks: 

Example: b_jump 


ErrSignChange 
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System Routines — Error 


ErrSingularMat 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Error 

Jumps to system error handler routine with the message ERR: SINGULARITY. 

None 

None 

None 

None 

None 

None 


B JUMP ErrSingularMat 
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System Routines — Error 


ErrStat 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: STAT. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B JUMP ErrStat 


TI-83 Plus Developer Guide 


3-25 


Third Release January 25, 2002 


System Routines — Error 


ErrStatPlot 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: STATPLOT. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B JUMP ErrStatPlot 
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System Routines — Error 


ErrSyntax 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: SYNTAX 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B JUMP ErrSyntax 


TI-83 Plus Developer Guide 


3-27 


Third Release January 25, 2002 


System Routines — Error 


ErrTolTooSmall 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Error 

Jumps to system error handler routine with message ERR: TOL NOT MET. 

None 

None 

None 

None 

None 

None 


B JUMP ErrTolTooSmall 


TI-83 Plus Developer Guide 


3-28 


Third Release January 25, 2002 


System Routines — Error 


Errllndefined 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: UNDEFINED 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

B_JUMP ErrUndefined 
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System Routines — Error 


JError 


Category: 

Description: 

Error 

Entry point into system error routine. This entry is almost always used in 
conjunction with an error exception handler. 

After an error exception handler is tripped and control is returned to an 
application, the application may choose to modify the error by changing the 
error to another or most likely removing the GoTo option. This entry point is 
where the application would B_JUMP to continue on with the error after 
modifying it. 

See the Error Handers section in Chapter 2. 


inputs: 

Registers: ACC bits (0 - 6) = error code 

ACC bit (7) = 0 for no GoTo option 
ACC bit (7) = 1 for allowing a GoTo option 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 


Others: 

(errNo) = error code (one-byte) 

System error is displayed or another error. 

Exception handler is tripped and the error is suppressed. 

Registers 

destroyed: 

Remarks: 

All 

Example: 
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System Routines — Error 


JErrorNo 

Category: 

Description: 

Remarks: 


Error 

Same as JError except the error code is stored in the byte (errNo). 


See JError. 
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System Routines - Floating Point Stack 



System Routines — 
Floating Point Stack 


AllocFPS 

AllocFPSI 

CpyStack 

CpyOIToFPST, CpyOIToFPSI , Cpy01ToFPS2, Cpy01ToFPS3, 
Cpy01ToFPS4, Cpy01ToFPS5, Cpy01ToFPS6, Cpy01ToFPS7, 
Cpy02ToFPST, Cpy02ToFPS1 , Cpy02ToFPS2, Cpy02ToFPS3, 
Cpy02ToFPS4, Cpy03ToFPST, Cpy03ToFPS1 , Cpy03ToFPS2, 
Cpy05ToFPS1 , Cpy05ToFPS3, Cpy06ToFPST, Cpy06ToFPS2 

CpyTol FPST, CpyTol FPS1 , CpyTol FPS2, CpyTol FPS3, CpyTol FPS4, 
CpyTol FPS5, CpyTol FPS6, CpyTol FPS7, CpyTol FPS8, CpyTol FPS9, 
CpyTol FPS1 0, CpyTol FPS1 1 , CpyTo2FPST, CpyTo2FPS1 , CpyTo2FPS2, 
CpyTo2FPS3, CpyTo2FPS4, CpyTo2FPS5, CpyTo2FPS6, CpyTo2FPS7, 
CpyTo2FPS8, CpyTo3FPST, CpyTo3FPS1 , CpyTo3FPS2, CpyTo4FPST, 
CpyTo5FPST, CpyTo6FPST, CpyTo6FPS2, CpyTo6FPS3 

CpyToFPST 

CpyToFPSI 

CpyToFPS2 

CpyToFPS3 

CpyToStack 

PopMCpIxOI 

PopOPI, PopOP3, PopOP5 

PopReal 

PopRealOl, PopReal02, PopReal03, PopReal04, PopReal05, PopReal06 

PushMCpIxOI, PushMCplx03 

PushOPI, PushOP3, PushOP5 

PushReal 

PushRealOl, PushReal02, PushReal03, PushReal04, PushReal05, 
PushReal06 


4-1 

4j2 

4-3 


4-4 


..£5 

..±6 

.. 4-7 

..£8 

..4j9 

4^To 

4j7 

£42 

4dl 

£44 

4T5 

m 

4^47 


4-18 
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System Routines - Floating Point Stack 


AllocFPS 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Floating Point Stack 

Allocates space on the Floating Point Stack by specifying a number of 
nine-byte entries. 

HL = number of entries to allocate 

None 

None 


None 

None 

If no memory error, the new entries are allocated on the end of the FPS. 
FPST = last new entry allocated. 

All 


No initialization of the allocated entries is done. See section on Floating Point 
Stack. 
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System Routines — Floating Point Stack 


AllocFPSI 


Category: Floating Point Stack 

Description: Allocates space on the Floating Point Stack by specifying a number of bytes, 

THIS MUST BE A MULTIPLE OF NINE. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


HL = number of bytes to allocate — a multiple of nine. 

None 

None 

None 

None 

If no memory error, the new entries are allocated on the end of the FPS. 
FPST = last new entry allocated. 


Registers All 
destroyed: 

Remarks: No check is made for the number of bytes being a multiple of nine. No 

initialization of the allocated entries is done. See section on Floating Point 
Stack. 


Example: 
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System Routines — Floating Point Stack 


CpyStack 

Category: 

Description: 


input: 

Registers: 


Flags: 

Others: 

Output: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Floating Point Stack 

Copies nine-bytes from one of the systems nine-byte stacks, FPS and ES. 
Only the FPS (Floating Point Stack) is documented for application use. This 
routine should be used in the manner described in the example. 


C = number of bytes from the next free byte in the stack back to the entry 
copying from. This will always be a multiple of nine. 

HL = address of next free byte for the stack, for the FPS the address is stored 
in the bytes (FPS). 

DE = pointer to the nine-bytes of RAM to copy the entry to. 

None 

None 


HL = pointer to byte after the entry just copied from. 
DE = DE + 9 

None 

Nine bytes copied to the RAM from the stack entry. 
All 

See Floating Point Stack documentation. 

Copy from FPS1 0 to OP2. 


LD 

HL, (FPS) 

; copy to FPS 

LD 

DE, (OP2 ) 

; start of 9 bytes to copy to 



; FPS10 

LD 

C, (10+1) *9 

; C = offset back to FPS10, 



; 11*9 bytes 

B_CALL 

CpyStack 

; copy to OP2 from FPS10 
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System Routines — Floating Point Stack 


CpyOIToFPST, 

Cpy01ToFPS3, 

Cpy01ToFPS6, 

Cpy02ToFPS1, 

Cpy02ToFPS4, 

Cpy03ToFPS2, 

Cpy06ToFPST, 


CpyOIToFPSI, 

Cpy01ToFPS4, 

Cpy01ToFPS7, 

Cpy02ToFPS2, 

Cpy03ToFPST, 

Cpy05ToFPS1, 

Cpy06ToFPS2 


Cpy01ToFPS2, 

Cpy01ToFPS5, 

Cpy02ToFPST, 

Cpy02ToFPS3, 

Cpy03ToFPS1, 

Cpy05ToFPS3, 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Floating Point Stack 

This description covers a group of routines that copies a single nine-byte OP 
register (OP1 - OP6), to an entry on the Floating Point Stack (FPS). 

For example, Cpy01ToFPS2: OP1 is copied to (FPS2). 


None 

None 

OP register = 9 bytes to copy to FPS entry 

For example, Cpy01ToFPS2: OP1 = nine-bytes to copy 


DE = FPS entry following the one copied to 

For example, Cpy01ToFPS2: DE = address of FPS1 

HL = OP register + 9 

For example, Cpy01ToFPS2: HL = OP1 + 9 
None 

OP register = copy of the nine-byte FPS entry 
For example, CpyTo1FPS2: OP1 = FPS2 entry 

All 

The OP register is written to. 

These routines do not allocate or deallocate entries. See entry point 
CpyToStack. See entry point CpyTolFPST. See Floating Point Stack section 
of Chapter 2. 
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CpyTol FPST, 
CpyTol FPS3, 
CpyTol FPS6, 
CpyTol FPS9, 
CpyTo2FPST, 
CpyTo2FPS3, 
CpyTo2FPS6, 
CpyTo3FPST, 
CpyTo4FPST, 
CpyTo6FPS2, 


CpyTol FPS1 , CpyTol FPS2, 
CpyTol FPS4, CpyTol FPS5, 
CpyTol FPS7, CpyTol FPS8, 
CpyTol FPS1 0, CpyTol FPS1 1 , 
CpyTo2FPS1 , CpyTo2FPS2, 
CpyTo2FPS4, CpyTo2FPS5, 
CpyTo2FPS7, CpyTo2FPS8, 
CpyTo3FPS1, CpyTo3FPS2, 
CpyToSFPST, CpyTo6FPST, 
CpyTo6FPS3 


Category: 

Description: 


inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Floating Point Stack 

This description covers a group of routines that copies a single nine-byte entry 
from the Floating Point Stack (FPS), to one of the OP registers (OP1 - OP6). 
For example, CpyTol FPS2: (FPS2) is copied to OP1 . 


None 

None 

None 


HL = FPS entry following one copied 

For example, CpyTol FPS2: HL = address of FPS1 

DE = OP register + 9 

For example, CpyTol FPS2: DE = OP1 + 9 
None 

OP register = copy of the nine-byte FPS entry 
For example, CpyTol FPS2: OP1 = FPS2 entry 

All 

The OP register is written to. 

These routines do not allocate or deallocate entries. See entry point 
CpyStack. See entry point CpyOIToFPST. See Floating Point Stack section 
of Chapter 2. 
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CpyToFPST 


Category: 

Description: 

Input: 

Registers: 

Flags: 

Others: 

Output: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Floating Point Stack 

Copies nine-bytes from RAM/ROM to FPST, Floating Point Stack top entry. 

DE = address of nine-bytes to copy to FPST 

None 

None 

HL = input DE + 9 

DE = (FPS), next free byte on the stack 

None 

None 

All 

See Floating Point Stack documentation. 
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CpyToFPSI 


Category: 

Description: 

Input: 

Registers: 

Flags: 

Others: 

Output: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Floating Point Stack 

Copies nine-bytes from RAM/ROM to FPS1 , Floating Point Stack top entry -1 . 

DE = address of nine-bytes to copy to FPS1 

None 

None 

HL = input DE + 9 

DE = pointer to FPST entry 

None 

None 

All 

See Floating Point Stack documentation. 


TI-83 Plus Developer Guide 


4-7 


Third Release January 25, 2002 


System Routines — Floating Point Stack 


CpyToFPS2 


Category: 

Description: 

Input: 

Registers: 

Flags: 

Others: 

Output: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Floating Point Stack 

Copies nine-bytes from RAM/ROM to FPS2, Floating Point Stack top entry -2. 

DE = address of nine-bytes to copy to FPS2 

None 

None 

HL = input DE + 9 

DE = pointer to FPS1 entry 

None 

None 

All 

See Floating Point Stack documentation. 
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CpyToFPS3 


Category: 

Description: 

Input: 

Registers: 

Flags: 

Others: 

Output: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Floating Point Stack 

Copies nine-bytes from RAM/ROM to FPS3, Floating Point Stack top entry -3. 

DE = address of nine-bytes to copy to FPS3 

None 

None 

HL = input DE + 9 

DE = pointer to FPS2 entry 

None 

None 

All 

See Floating Point Stack documentation. 


TI-83 Plus Developer Guide 


4-9 


Third Release January 25, 2002 


System Routines — Floating Point Stack 


CpyToStack 


Category: 

Description: 


input: 

Registers: 


Flags: 

Others: 

Output: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Floating Point Stack 

Copies nine-bytes to one of the systems nine-byte stacks, FPS and ES. Only 
the FPS (Floating Point Stack) is documented for application use. This routine 
should be used in the manner described in the example. 


C = number of bytes from the next free byte in the stack back to the entry 
copying to. This will always be a multiple of nine. 

HL = address of next free byte for the stack, for the FPS the address is stored 
in the bytes (FPS). 

DE = pointer to the nine-bytes to copy to the stack. 

None 

None 


HL = pointer to byte after the entry just copied to. 
DE = DE + 9 

None 

Nine-bytes copied to the stack entry. 

All 

See Floating Point Stack documentation. 

Copy from OP2 to FPS10. 


LD 

HL, (FPS) 

; copy to FPS 

LD 

DE, (OP2 ) 

; start of 9 bytes to copy to 
; FPS10 

LD 

C, (10+1) *9 

; C = offset back to FPS10, 

; 11*9 bytes 

B_CALL 

CpyToStack 

; copy to FPS 10 
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PopMCpIxOI 


Category: Floating Point Stack 

Description: Pops a complex value from the FPS (FPS1 = real part; FPST = imaginary 

part). No checks are made on the data that is popped from the stack. 


Inputs: 

Registers: None 
Flags: None 

Others: FPS1 = real part of complex number 

FPST = imaginary part of complex number 


Outputs: 

Registers: None 
Flags: None 

Others: OP1 contains 9 bytes of data from FPS1 

OP2 contains 9 bytes of data from FPST 


Registers All 
destroyed: 

Remarks: This routine will remove 18 bytes of data from the FPS regardless of the data 

type. 

See PopRealOl, PopOPI. See the Floating Point Stack section. 


Example: 
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PopOPI, PopOP3, PopOP5 


Category: 

Description: 


Input: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

RAM used: 
Remarks: 


Example: 


Floating Point Stack 

This description covers three entry points that are similar. The description is 
given for PopOPI . The inputs/outputs are the same for the other two routines 
replacing OP1/OP2 with either OP3/OP4 or OP5/OP6. 

These routines will pop either one or two floating-point numbers off of the top 
of the FPS. They are used to either pop a real or a complex value off of the top 
of the FPS without knowing in advance whether a real or a complex value is 
on the top of the stack. 

The top entry (FPST) is popped into OP1 . The sign byte of the popped value in 
OP1 is checked for CpixObj. If it is complex, OP1 is moved to OP2 and the 
new FPST is popped into OP1 . If it is not complex, the floating-point number 
popped into OP1 is left there. 


None 

None 

None 


None 

None 

If the data type of FPST = RealObj then OP1 = FPST 
If the data type of FPST = CpixObj then OP1 = FPS1 , 
the real part of the complex value 
OP2 = FPST, the imaginary part of the complex value. 

All 


OP1/OP2 or OP3/OP4 or OP5/OP6 depending on which of the routines is 
used. 

When using this routine make sure that the FPST entry is not a complex 
variable name. If it is, it will be interpreted as a complex value causing two 
floating-point numbers to be popped from the FPS. See PopRealOl and 
PopMcpIxOI. See Floating Point Stack section. 
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PopReal 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Floating Point Stack 

Pops the last entry FPST, off of the FPS to an input RAM location. No matter 
what the data in FPST is only nine (9) bytes are popped off of the stack. 

DE = pointer to RAM location to pop FPST into 

None 

None 


DE = DE + 9 
None 

The nine-byte entry FPST is removed from the FPS and copied to the 
nine-bytes starting at address DE. 

All but the ACC 

The entry is removed from the FPS shrinking the size of the FPS by 
nine-bytes. See the Floating Point Stack section. 
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PopRealOl, PopReal02, PopReal03, PopReal04, 
PopReal05, PopReal06 


Category: Floating Point Stack 

Description: This description covers six entry points that are similar. The description is 

given for PopRealOl. The inputs/outputs are the same for the other five 
routines replacing OP1 with either OP2, OP3, OP4, OP5 or OP6. 

Pops the last entry FPST, off of the FPS to OP1 . No matter what the data in 
FPST is, only nine (9) bytes are popped off of the stack. 


Inputs: 

Registers: None 
Flags: None 

Others: None 


Outputs: 

Registers: None 
Flags: None 

Others: The nine-byte entry FPST is removed from the FPS and copied to the 

nine-bytes starting at address OP1 . 

Registers 

destroyed: 


Remarks: The entry is removed from the FPS shrinking the size of the FPS by 

nine-bytes. See PopOPI. See the Floating Point Stack section. 


Example: 
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PushMCpIxOI, PushMCplx03 


Category: 

Description: 


inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Floating Point Stack 

PushMCpIxOI pushes a complex value onto the FPS (OP1 = real part; OP2 = 
imaginary part). No checks are made on the data that is put onto the stack. 
PushMCplx03 accomplishes the same task, except inputs are OP3 and OP4. 


None 

None 

(OP1)...(OP1+8) and (OP2)...(OP2+8) contain 18 bytes of data to be pushed. 

None 

None 

FPS1 = 9 bytes from OP1 
FPST = 9 bytes from OP2 
All 

Memory error if not enough free RAM. 

See PushRealOl , PushOPI . See the Floating Point Stack section. 
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PushOPI, PushOP3, PushOPS 


Category: 

Description: 

Floating Point Stack 

This description covers three entry points that are similar. The description is 
given for PushOPI . The inputs/outputs are the same for the other two routines 
replacing OP1/OP2 with either OP3/OP4 or OP5/OP6. 

These routines will push either one or two floating-point numbers onto the 

FPS. It is used to either push a real or a complex value onto the FPS without 
knowing in advance whether a real or a complex value is being pushed onto 
the stack. 

The sign byte of OP1 is checked for CpixObj. If it is Complex, OP1 is pushed 
on to the stack and the OP2 is pushed onto the stack. If it is not complex, the 
floating-point number in OP1 is only pushed onto the stack. 


Input: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

If the data type of OP1 = RealObj then FPST = OP1 

If the data type of OP1 = CpixObj then FPS1 = OP1 , 
the real part of the complex value 

FPST = OP2, the imaginary part of the complex value. 

Registers 

destroyed: 

RAM used: 

All 

None 

Remarks: 

When using this routine make sure that the OP1 is not a complex variable 
name. If it is it will be interpreted as a complex value causing two floating-point 
numbers to be pushed onto the FPS. See PushRealOl, PushMcpixOI. See 
the Floating Point Stack section. 

Example: 
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PushReal 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Floating Point Stack 

Pushes a new entry onto the FPS and copy the nine-bytes at address HL into 
the new entry. No checks are made on the data that is put onto the stack. 

HL = pointer to nine-bytes to push onto the FPS 

None 

None 

HL= HL + 9 
None 

FPST = nine-bytes at HL pushed onto the stack 
All 

The previous FPST is now entry FPS1. See PushRealOl, PushOPI. See the 
Floating Point Stack section. 
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PushRealOl, PushReal02, PushReal03, PushReal04, 
PushReal05, PushReal06 


Category: Floating Point Stack 

Description: This description covers six entry points that are similar. The description is 

given for PushRealOl . The inputs/outputs are the same for the other five 
routines replacing OP1 with either OP2, OP3, OP4, OP5 or OP6. 

Pushes a new entry onto the FPS and copy the nine-bytes at OP1 into the new 
entry. No checks are made on the data that is put onto the stack. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


None 

None 

OP1 = nine-bytes to push onto the FPS 

None 

None 

FPST = nine-bytes at OP1 pushed onto the stack 


The previous FPST is now entry FPSI. See PushReal, PushOPI. See the 
Floating Point Stack section. 


Example: 
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System Routines — 
Graphing and Drawing 


AIIEq . 


5-1 


BufClr \^2\ 


BufCpy 1 5-3 


CircCmd 5-4 


CircCmd (continued) |5-5 


ClearRect 5-6 


CLine 5-7 


CLine (continued) 5-8 


CLineS 5-9 


CLineS (continued) |5-10| 

ClrGraphRef |5-1 1 1 


CPoint 15-121 


CPoint (continued) 15-13 


CPointS 5-14 


CPointS (continued) 15-15 


DarkLine 5-16 


DarkLine (continued) |5-17 


DarkPnt 5-18 


DarkPnt (continued) |5-19 

Disp 


5-20 


DrawCirc2 5-21 


DrawCirc2 (continued) |5-22 


DrawCmd 5-23 


DrawRectBorder 5-24 


DrawRectBorderClear 5-25 


EraseRectBorder 5-26 


FillRect 5-27 
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FillRect (continued) 

FillRectPattern 

FillRectPattern ( continued ) 

GrBufClr 

GrBufCpy 

GrphCirc 

FlorizCmd 

IBounds 

IBoundsFull 

ILine 

I Line (continued) 

InvCmd 

InvertRect 

lOffset 

IPoint 

I Point (continued) 

LineCmd 

LineCmd (continued) 

PDspGrph 

PixelTest 

PointCmd 

PointCmd (continued) 

PointOn 

Regraph 

SetAIIPIots 

SetFuncM 

SetParM 

SetPolM 

SetSeqM 

SetTbIGraphDraw 

TanLnF 

UCLineS 


5-28 

5^29 

5430 

543T 

5432 

5433 

5434 

5435 

546 

547 

548 

549 
~540 

5^4T 

5^42 

5^43 

5-44 

545 

546 

547 
5^48 

^49 

440 

545 ? 

5452 

5453 
54)4 

545 

546 

547 

548 
F59l 
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AIIEq 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Graphing and Drawing 

Select or deselect all graph equations in the current graph mode. 

ACC = 3 to select all equations in the current graph mode 
= 4 to deselect all equations in the current graph mode 

Current graph mode: IY + grfModeFlags = flag byte 

None 

None 

None 

All graph equations for the current mode are selected or deselected. 
All 

OP1, OP2 
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BufClr 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Graphing and Drawing 

Executes the routine GrBufClr on a bitmap of the graph screen other than 
plotSScreen, the system graph backup buffer. 

HL = pointer to start of graph buffer to clear, 768 bytes 

None 

None 


None 

None 

RAM cleared. 
All 


G-T and Horizontal modes will affect how much of the buffer is cleared. In 
order to have the entire buffer cleared set to full screen mode. 

There are two additional bit image display buffers allocated other than 
plotSScreen , they start at addresses appBackUpScreen and saveSScreen. 

LD HL, appBackUpScreen 

B_CALL BufClr ; clear backup 
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BufCpy 

Category: 

Description: 


inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Graphing and Drawing 

Executes the routine GrBufCpy on a bitmap of the graph screen other that 
plotSScreen, the system graph backup buffer. The contents of the buffer are 
displayed. 


HL = pointer to start of graph buffer to display, 768 bytes 

None 

None 


None 

None 

None 

All 


G-T and Horizontal modes will affect how much of the buffer is displayed. In 
order to have the entire buffer displayed, set to full screen mode. 

There are two additional bit image display buffers allocated other than 
plotSScreen , they start at addresses appBackUpScreen and saveSScreen. 

LD HL, appBackUpScreen 

B_CALL BufCpy ; display backup buffer 
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CircCmd 

Category: Graphing and Drawing 

Description: Displays the current graph screen and draws a circle on the graph screen 

given the center and the radius, relative to the current window settings. 

Inputs: 

Registers: None 

Flags: useFastCirc, (IY + plotFlag3) = 1 for fast circle routine that draws the circle in 


Others: 

sections simultaneously 

useFastCirc, (IY + plotFlag3) = 0 for normal circle routine that draws in a 

circular direction 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

FPST = radius, a floating-point number 

FPS1 = Y value of center, a floating-point number 

FPS2 = X value of center, a floating-point number 

The center specified is with respect to the current window settings. 


Outputs: 

Registers: None 
Flags: None 


Others: 

Current graph, and point operation are drawn to the screen and the graph 
backup buffer, plotSScreen. 

Inputs are removed from the Floating Point Stack. 

Registers 

destroyed: 

Remarks: 

All 

If a zoom square is not done before using this routine the output circle will 
most likely not look circular but skewed in either the X or Y axis direction. 

If useFastCirc is used, the flag must be reset by the caller. 

(continued) 
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CircCmd (continued) 


Example: Execute a zoom standard and then draw a circle at (0,0) with radius 3 using 

the alternate fast circle draw. 


ClrFlag : 


B_CALL 

ZooDef ault 

; standard window 

B_CALL 

OPISetO 

; OP1 = 0 

RST 

rPushRealOl 


RST 

rPushRealOl 

; (0,0) pushed 

; onto FPS 

B_CALL 

OPlSet3 

; radius is 3 

RST 

rPushRealOl 

; 3 pushed onto 
; FPS 

SET 

useFastCirc, ( IY+plotFlag3 ) 

; fast circle 
; routine 

AppOnErr 

ClrFlag 

; set up error 
; handler to clear 
; fast circle flag 

B_CALL 

CircCmd 

r 

AppOf fErr 


; remove no error 

RES 

RET 

useFastCirc, ( IY+plotFlag3 ) 

; reset flag 

if error 

RES 

useFastCirc, ( IY+plotFlag3 ) 

; reset flag 

B JUMP 

JErrorNo 

; continue on with 


; system error 
; handle 
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ClearRect 


Category: 

Graphing and Drawing 


Description: 

Clears a rectangular area on the screen (to Pixel off). 

Inputs: 



Registers: 

H = upper left corner pixel row 

L = upper left corner pixel column 

D = lower right corner pixel row 

E = lower right corner pixel column 


Flags: 

plotLoc, (IY + plotFlags): 

0: update display and graph butter 

1 : update display only 


Others: 

None 


Outputs: 



Registers: 

None 


Flags: 

None 


Others: 

None 


Registers 

destroyed: 

All 


Remarks: 

Rectangle is defined by pixel coordinates, where row = 0, column = 0 is upper 
left corner of screen and row = 63, column = 95 is lower right corner of screen 


Area includes row and column of both coordinates. 

Inputs must satisfy conditions: D >= H, E >= L. 


Modifies saveSScreen RAM area. 


Example: 

LD HL, OOOOh 

LD DE, 3F5Fh 

B_CALL FillRect 

LD H, 0 

LD L, 4 8 

LD D,31 

LD E, 95 

B_CALL ClearRect 

B_CALL GetKey 

B JUMP JForceCmdNoChar 

; Make the whole screen 
; black 

; Clear the screen's top 
; right quarter 
; Get key press 
; Exit app 
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CLine 

Category: 

Description: 


Inputs: 

Registers: 


Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 


Graphing and Drawing 

Draws a line between two points specified by graph coordinates. The line is 
plotted according to the current window settings Xmin, Xmax, Ymin, Ymax. 

The points do not need to lie within the current window settings this routine will 
clip the line to the screen edges if any portion of the line goes through the 
current window settings. 

This routine should only be used to draw lines in reference to the window 
settings. 

ILine can be used to draw lines by defining points with pixel coordinates, 
which will be a faster draw. 


OP4 — Y1 -coordinate 
OP3 — XI -coordinate 
OP2 — Y2-coordinate 
OP1 — X2-coordinate 

G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. 

See ForceFullScreen. 

grfSplit, (IY + sGrFlags) = 1 if horizontal split mode set 
vertSplit, (IY + sGrFlags) = 1 if graph-table split mode set 
grfSplitOverride, (IY + sGrFlags) = 1 to ignore split modes 
plotLoc, (IY + plotFlags) = 1 to draw to the display only 

= 0 to draw to display and plotSScreen buffer. 
bufferOnly, (IY + plotFlag3) = 1 to draw to plotSScreen buffer only. 

None 


None 

None 

None 

All 

OP1 -OP6 

This routine does not copy the graph buffer to the screen or invoke a regraph if 
needed. Use PDspGrph to make sure the graph in the screen is valid. 

(continued) 
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CLine (continued) 


Example: 


LD 

LD 

LD 

LDIR 

LD 

B_CALL 

B_CALL 

r 

B_CALL 

RET 

Point_l : 

DB 

DB 

Point_2 : 

DB 

DB 


HL, Point_l 

DE, 0P3 
BC, 18 

HL, Point_2 

Mov90P10P2 

PushMCplxOl 

CLine 


0, 

80h, 

15h, 

0, 

.0, 

,0, 

.0, 

,0, 

. 0 

0, 

80h, 

30h, 

0, 

.0, 

,0, 

.0, 

,0, 

. 0 

0, 

80h, 

40h, 

0, 

.0, 

,0, 

.0, 

,0, 

. 0 

0, 

80h, 

60h, 

0, 

.0, 

,0, 

.0, 

,0, 

. 0 


Draw a line between 
the points (1.5,3) 

& (4,6): 

point to (1.5,3) in 
ROM 


point to (4,6) in 
ROM 

0P1 = 4 OP 2 = 6 


draw the line 


1.5 

3 

4 

6 
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CLineS 

Category: 

Description: 


Inputs: 

Registers: 


Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 


Graphing and Drawing 

Draws a line between two points specified by graph coordinates. The line is 
plotted according to the current window settings Xmin, Xmax, Ymin, Ymax. 

The points do not need to lie within the current window settings this routine will 
clip the line to the screen edges if any portion of the line goes through the 
current window settings. 

This routine should only be used to draw lines in reference to the window 
settings. 

ILine can be used to draw lines by defining points with pixel coordinates, 
which will be a faster draw. 


FPS2 — Y 1 -coordinate 
FPS3 — XI -coordinate 
FPST — Y2-coordinate 
FPS1 — X2-coordinate 

plotLoc, (IY + plotFlags) = 1 to draw to the display only 

= 0 to draw to display and plotSScreen buffer 
bufferOnly, (IY + plotFlag3) = 1 to draw to plotSScreen buffer only 

G-T and FIORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this turn off the split screen modes. 

See ForceFullScreen. 

grfSplit, (IY + sGrFlags) = 1 if horizontal split mode set 

vertSplit, (IY + sGrFlags) = 1 if graph-table split mode set 

grfSplitOverride, (IY + sGrFlags) = 1 to ignore split modes 

None 


None 

None 

None 

All 

OP1 - OP6 

This routine does not copy the graph buffer to the screen or invoke a regraph if 
needed. Use PDspGrph to make sure the graph in the screen is valid. 

(continued) 
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CLineS (continued) 

Example: 


Point_l : 

Point_2 : 




; Draw a line between 
; the points (1.5,3) 

; & (4,6) : 

LD 

HL, Point_l 

; point to (1.5,3) in 
; ROM 

B_CALL 

Mov90P10P2 

; OP1 =1.5 OP 2 = 3 

B_CALL 

PushMCplxOl 

; push OP1 and then 
; OP 2 onto the FPS 

LD 

HL, Point_2 

; point to (4,6) in 
; ROM 

B_CALL 

Mov90P10P2 

; OP1 = 4 OP 2 = 6 

B_CALL 

PushMCplxOl 

; push OP1 and then 
; OP 2 onto the FPS 

B_CALL 

CLineS 

; draw the line 

RET 



DB 

0, 80h, 15h, 0, 0, 0, 0, 0, 0 

; 1.5 

DB 

0, 80h, 30h, 0, 0, 0, 0, 0, 0 

; 3 

DB 

0, 80h, 40h, 0, 0, 0, 0, 0, 0 

; 4 

DB 

0, 80h, 60h, 0, 0, 0, 0, 0, 0 

; 6 
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ClrGraphRef 

Category: Graphing and Drawing 

Description: Clears all graph reference flags in the symtable and the temporary symtable. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

Graph reference reset 

HL, DE, BC 

Example: 

B_CALL ClrGraphRef 
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CPoint 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Graphing and Drawing 

Turns on, turns off, or inverts a point in the display specified by graph 
coordinates. The point is plotted according to the current window settings: 
Xmin, Xmax, Ymin, Ymax. 

This routine should only be used to draw points in reference to the window 
settings. 

IPoint can be used to draw points by defining points with pixel coordinates, 
which causes a faster draw. 


ACC = what to do 
0: turn point off 
1 : turn point on 
2: invert point 

G-T and HORIZ split-screen modes affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. 

See ForceFullScreen. 


grfSplit, (IY + sGrFlags) 
vertSplit, (IY + sGrFlags) 
grfSplitOverride, (IY + sGrFlags) 
plotLoc, (IY + plotFlags) 


bufferOnly, (IY + plotFlag3) 

OP1 — X Coordinate of point 
OP2 — Y Coordinate of point 


1 if horizontal split mode set 
1 if graph-table split mode set 
1 to ignore split modes 
1 to draw to the display only 

0 to draw to display and plotSScreen 
buffer 

1 to draw to plotSScreen buffer only 


None 

None 

None 

All 

This routine does not copy the graph buffer to the screen or invoke a regraph if 
needed. Use PDspGrph to make sure the graph in the screen is valid. 

(continued) 


TI-83 Plus Developer Guide 


5-12 


Third Release January 25, 2002 


System Routines — Graphing and Drawing 


CPoint (continued) 

Example: Draw a point in the graph window at coordinates (1 .5,3): 


LD 

HL, Point_l 

; point to (1.5,3) 

B_CALL 

Mov90P10P2 

; OP1 =1.5 OP 2 = 

LD 

A, 1 

; turn on 

B_CALL 

CPoint 

; draw the point 

RET 



DB 

0, 80H, 15H, 0, 0, 0, 0, 0, 0 

; 1.5 

DB 

0, 80H, 30H, 0, 0, 0, 0, 0, 0 

; 3 


TI-83 Plus Developer Guide 


5-13 


Third Release January 25, 2002 


System Routines — Graphing and Drawing 


CPointS 

Category: 

Description: 


Inputs: 

Registers: 


Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Graphing and Drawing 

Turns on, turns off or inverts a point in the display specified by graph 
coordinates. The point is plotted according to the current window settings: 
Xmin, Xmax, Ymin, Ymax. 

This routine should only be used to draw points in reference to the window 
settings. 

IPoint can be used to draw points by defining points with pixel coordinates, 
which causes a faster draw. 


ACC = what to do 
0: turn point off 
1 : turn point on 
2: invert point 

G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. 

See ForceFullScreen. 


grfSplit, (IY + sGrFlags) 
vertSplit, (IY + sGrFlags) 
grfSplitOverride, (IY + sGrFlags) 
plotLoc, (IY + plotFlags) 


bufferOnly, (IY + plotFlag3) 

FPS1 — X Coordinate of point 
FPST — Y Coordinate of point 


1 if horizontal split mode set 
1 if graph-table split mode set 
1 to ignore split modes 
1 to draw to the display only 

0 to draw to display and plotSScreen 
buffer 

1 to draw to plotSScreen buffer only 


None 

None 

None 

All 

This routine does not copy the graph buffer to the screen or invoke a regraph if 
needed. Use PDspGrph to make sure the graph in the screen is valid. 

(continued) 
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CPointS (continued) 

Example: Draw a point in the graph window at coordinates (1 .5,3) 


LD 

HL, Point_l 

; point to 
; in ROM 

(1.5,3) 

B_CALL 

Mov90P10P2 

; OP1 = 1. 

5 OP 2 = 3 

B_CALL 

PushMCplxOl 

; push OP1 

and then 



; OP2 onto 

the FPS 

LD 

A, 1 

; turn on 


B_CALL 

CPointS 

; draw the 

point 

RET 




DB 

0, 80H, 15H, 0, 0, 0, 0, 0, 0 

; 1.5 


DB 

0, 80H, 30H, 0, 0, 0, 0, 0, 0 

; 3 
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DarkLine 

Category: 

Description: 

Inputs: 


Registers: 


Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Graphing and Drawing 

Draws a line between two pixel points defined by their pixel coordinates. 

The graph window is defined with the lower left corner of the display to be pixel 
coordinate (0,0). 

The system graphing routines do not normally draw in the last column and the 
bottom row of the screen, column 95 and row 0. 

This routine can be made to use column 95 and row 0 by setting the flag: 
fullScrnDraw, (IY + apiFlg4) 

X = column 
Y = row 


B = X-coordinate of first point — 0...94 (95) see above 
C = Y-coordinate of first point — 1 (0)...63 
D = X-coordinate of second point — 0...94 (95) 

E = Y-coordinate of second point — 1 (0)...63 


fullScrnDraw, (IY + apiFlg4) 
plotLoc, (IY + plotFlags) 

bufferOnly, (IY + plotFlag3) 
None 


1 to use column 95 and row 0 
1 to draw to the display only 

0 to draw to display and plotSScreen buffer 

1 to draw to plotSScreen buffer only 


None 

None 

Line drawn where specified. 
All registers are preserved. 


If the draw is going to the buffer then the contents of the buffer are used to 
draw the line and copied to the screen. 

No clipping, X, Y points assumed to be defined on the screen. 

G-T and FIORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. 

See ForceFullScreen. 


(continued) 
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DarkLine 

Example: 


(continued) 

; Clear the screen. 

; Draw a line in the display only, between pixel 


; and (62,50) : 

B_CALL 

LD 

LD 

/ 

SET 

t 

B_CALL 


ClrLCD 

BC, 25*256+30 
DE , 62*256+50 

plotLoc, ( IY+plotFlags ) 
DarkLine 


coordinates (25,30) 

; clear the screen; 

; 1st point, B = 25, 
; C = 30 

; 2nd point, D = 62, 
; E = 50 

; display only 

; draw the line 
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DarkPnt 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Graphing and Drawing 

Turns on a point in the display specified by graph coordinates. 

The point is plotted according to the current window settings: 

Xmin, Xmax, Ymin, Ymax. 

This routine should only be used to draw points in reference to the window 
settings. 

IPoint can be used to draw points by defining points with pixel coordinates, 
which causes a faster draw. 


None 

G-T and HORIZ split screen modes affect how this routine maps the 
coordinates specified. To avoid this, turn off the split-screen modes. 

See ForceFullScreen. 


grfSplit, (IY + sGrFlags) 
vertSplit, (IY + sGrFlags) 
grfSplitOverride, (IY + sGrFlags) 
plotLoc, (IY + plotFlags) 


bufferOnly, (IY + plotFlag3) 

OP1 — X Coordinate of point 
OP2 — Y Coordinate of point 


1 if horizontal split mode set 
1 if graph-table split mode set 
1 to ignore split modes 
1 to draw to the display only 

0 to draw to display and plotSScreen 
buffer. 

1 to draw to plotSScreen buffer only 


None 

None 

None 

All 


This routine does not copy the graph buffer to the screen or invoke a regraph, 
if needed. Use PDspGrph to make sure the graph in the screen is valid. 

(continued) 
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DarkPnt (continued) 

Example: Draw a point in the graph window at coordinates (1 .5,3): 


LD 

HL, Point_l 

; point to (1.5, 

; i n ROM 

3) 

B_CALL 

Mov90P10P2 

; OP1 =1.5 OP 2 ^ 

= 3 

B_CALL 

DarkPnt 

; draw the point 


RET 




DB 

0, 80h, 15h, 0, 0, 0, 0, 0, 0 

; 1.5 


DB 

0, 80h, 30h, 0, 0, 0, 0, 0, 0 

; 3 
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Disp 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Graphing and Drawing 

Checks if graph screen is in the display. If it is, restores the text shadow to the 
screen. 

None 

None 

None 


None 

shiftFlags, textFlags 
curRow, curCol, winTop 
All 


This is intended to be used when an application uses both the home screen 
and the graph screen. 

Using this routine allows the application to switch between the home screen 
and the graph screen without having to rebuild the home screen. 

When switching to the graph screen, all of the text previously written to the 
home screen should have been also written to the text shadow. 

The plotLoc flag should be set when switching to the graph screen. 
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DrawCirc2 


Category: 

Description: 


inputs: 

Registers: 

Flags: 


Others: 


Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

Remarks: 


Graphing and Drawing 

Draws a circle given the center and the radius, relative to the current window 
settings. 

The current graph screen is not put into the display by this routine. 

This icircle routine is one of two available, and is the faster of the two. 


None 

plotLoc, (IY + plotFlags) = 1 to draw to the display only 
plotLoc, (IY + plotFlags) = 0 to draw to display and buffer 
bufferOnly, (IY + plotFlag3) = 1 to draw to buffer only 

FPST = radius, a floating-point number 

FPS1 = Y value of center, a floating-point number 

FPS2 = X value of center, a floating-point number 

The center specified is with respect to the current window settings. 


None 

None 

Circle is drawn either to the display, the buffer, or both. 
Inputs are removed from the Floating Point Stack. 

All 


If a zoom square is not done before using this routine the output circle will 
most likely not look circular but skewed in either the X or Y axis direction. 
See CircCmd. See Floating Point Stack section. 

(continued) 
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DrawCirc2 (continued) 

Example: Execute a zoom standard and then draw a circle at (0,0) with radius 3. 


B_CALL 

ZooDef ault 

; standard window 


B_CALL 

PDspGrph 

; get current graph 
; display 

to the 

B_CALL 

RST 

OPISetO 

rPushRealOl 

; OP1 = 0 


RST 

rPushRealOl 

; (0,0) pushed onto 

FPS 

B_CALL 

OPlSet3 

; radius is 3 


RST 

rPushRealOl 

; 3 pushed onto FPS 


AppOnErr 

circerr 

; set up error handler 

B_CALL 

AppOf fErr 

RET 

DrawCirc2 

r 

; remove no error 



; come here if error 

r 

Circerr : 
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DrawCmd 

Category: Graphing and Drawing 

Description: Displays the current graph screen and draws a function on it. Same as 

TI-83 Plus instruction DrawF. 


Inputs: 

Registers: None 

Flags: graphDraw, (IY + graphFlags) = 1 if current graph is dirty and needs to be 

redrawn 

= 0 if graph buffer is up to date and is copied 
to the screen 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

Others: FPST = name of equation to evaluate and draw, with X being the independent 

variable. 


Outputs: 

Registers: None 
Flags: None 

Others: Current graph and function are drawn to the screen and the graph backup 

buffer, plotSScreen. 

FPST = name of equation drawn, this must be cleaned by the calling routine. 


Registers All 

destroyed: 

RAM used: OP1 -OP6 


Remarks: 

Example: 


Errors can be generated during the draw, see Error Plandlers section. 
See section on Floating Point Stack 

Draw Y1 on the graph screen. 


LD 

HL, Ylname 



B_CALL 

Mov9ToOPl 

; OP1 = 

Y1 

B_CALL 

PushRealOl 

; push 

Y1 into 

B_CALL 

DrawCmd 

; draw 


B_CALL 

PopRealOl 

; clean 

Y1 off 
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DrawRectBorder 


Category: 

Description: 

Inputs: 

Registers: 


Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Graphing and Drawing 

Draws a rectangular outline on the screen. 


H = upper left corner pixel row 
L = upper left corner pixel column 
D = lower right corner pixel row 
E = lower right corner pixel column 

plotLoc, (IY + plotFlags): 

0: update display and graph buffer 
1 : update display only 

None 


None 

None 

None 

All 


Rectangle is defined by pixel coordinates, where row = 0, column = 0 is the 
upper left corner of screen and row = 63, column = 95 is the lower right corner 
of screen. 

Area includes row and column of both coordinates. 

Inputs must satisfy conditions: D >= H, E >= L 

Modifies saveSScreen RAM area. 


LD 

HL, OOOOh 


LD 

DE, 3F5Fh 


B_CALL 

DrawRectBorder 

; Draw an outline around 
; the screen 

B_CALL 

GetKey 

; Get key press 

B JUMP 

JForceCmdNoChar 

; Exit app 


TI-83 Plus Developer Guide 


5-24 


Third Release January 25, 2002 


System Routines — Graphing and Drawing 


DrawRectBorderClear 


Category: Graphing and Drawing 

Description: Draws a rectangular outline on the screen and clears the area inside the 

outline. 

Inputs: 

Registers: H = upper left corner pixel row 

L = upper left corner pixel column 
D = lower right corner pixel row 
E = lower right corner pixel column 

Flags: plotLoc, (IY + plotFlags): 

0: update display and graph buffer 
1 : update display only 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: None 


Registers All 
destroyed: 

Remarks: Rectangle is defined by pixel coordinates, where row = 0, column = 0 is the 

upper left corner of screen and row = 63, column = 95 is the lower right corner 
of screen. 


Area includes row and column of both coordinates. 
Inputs must satisfy conditions: D >= H, E >= L. 

Modifies saveSScreen RAM area. 


Example: 


B_CALL 

ClrLCDFull 


LD 

H, 32 


LD 

L, 48 


LD 

D, 63 


LD 

E, 95 


B_CALL 

FillRect 

; Blacken the screen's 
; lower right quarter 

B_CALL 

GetKey 

; Get key press 

LD 

HL, OOOOh 


LD 

DE, 3F5Fh 


B_CALL 

DrawRectBorderClear 

; Draw an outline 


; around the screen and 
; clear inside 


B_CALL 

GetKey 

; Get key press 

B JUMP 

JForceCmdNoChar 

; Exit app 
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EraseRectBorder 


Category: 


Graphing and Drawing 


Description: Erases a rectangular outline on the screen (to white). 

Inputs: 


Registers: H 
L = 
D 
E 


= upper left corner pixel row 
upper left corner pixel column 
= lower right corner pixel row 
: lower right corner pixel column 


Flags: plotLoc, (IY + plotFlags): 

0: update display and graph buffer 
1 : update display only 

Others: None 

Outputs: 

Registers: None 


Flags 

Others: 


None 

None 


Registers All 
destroyed: 

Remarks: Rectangle is defined by pixel coordinates, where row = 0, column = 0 is the 

upper left corner of screen and row = 63, column = 95 is the lower right corner 
of screen. 


Area includes row and column of both coordinates. 
Inputs must satisfy conditions: D >= H, E >= L 

Modifies saveSScreen RAM area. 


Example: 


LD 

HL, OOOOh 


LD 

DE, 3F5Fh 


B_CALL 

DrawRect Border 

; Draw an outline around the 

; screen 

B_CALL 

GetKey 

; Get key press 

B_CALL 

EraseRectBorder 

; Erase an outline around 
; the screen 

B_CALL 

GetKey 

; Get key press 

B JUMP 

JForceCmdNoChar 

; Exit app 
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FillRect 

Category: 

Description: 

Inputs: 

Registers: 


Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Graphing and Drawing 

Fills a rectangular area on the screen (to black). 


H = upper left corner pixel row 
L = upper left corner pixel column 
D = lower right corner pixel row 
E = lower right corner pixel column 

plotLoc, (IY + plotFlags): 

0: update display and graph buffer 
1 : update display only 

None 


None 

None 

None 

All 

Rectangle is defined by pixel coordinates, where row = 0, column = 0 is the 
upper left corner of screen and row = 63, column = 95 is the lower right corner 
of screen. 

Area includes row and column of both coordinates. 

Inputs must satisfy conditions: D >= H, E >= L 

Modifies saveSScreen RAM area. 

(continued) 
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FillRect (continued) 

Example: 


B_CALL 

ClrLCDFull 

; Clear the whole screen 

LD 

HL, lC2Ch 


LD 

DE, 2232h 


B_CALL 

FillRect 

; Put black square in 
; screen center 

B_CALL 

GetKey 

; Get key press 

LD 

H, 0 


LD 

L, 0 


LD 

D, 63 


LD 

E, 95 


B_CALL 

InvertRect 

; Turn to white square on 
; black background 

B_CALL 

GetKey 

; Get key press 

LD 

H, OOOOh 


LD 

D, 3F5Fh 


B_CALL 

InvertRect 

; Return to black square on 
; white background 

B_CALL 

GetKey 

; Get key press 

B JUMP 

Jf orceCmdNoChar 

; Exit app 
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FillRectPattern 

Category: Graphing and Drawing 

Description: Fills a rectangular area on the screen with a pattern 

Inputs: 

Registers: H = upper left corner pixel row 

L = upper left corner pixel column 


Flags: 

D = lower right corner pixel row 

E = lower right corner pixel column 

plotLoc, (IY + plotFlags): 

0: update display and graph butter 

1 : update display only 

Others: 

RectFillPHeight = pattern’s height in pixel rows (byte, 1 - 8) 

RectFilIPWidth = pattern’s width in pixel columns (byte, 1 - 8) 

RectFillPattern = one-byte for each pattern pixel row 

Pattern is right justified — bit 0 is right-most pixel in pattern row. First byte is 
the top row of the pattern. 


Outputs: 

Registers: None 
Flags: None 


Others: 

None 

Registers 

destroyed: 

Remarks: 

All 

Rectangle is defined by pixel coordinates, where row = 0, column = 0 is upper 
left corner of screen and row = 63, column = 95 is lower right corner of screen 

Area includes row and column of both coordinates. 

Inputs must satisfy conditions: D H, E L. 

You should not use the right-most column (95). This routine fails if you try to 
use it. 

Modifies saveSScreen RAM area. 

The pattern is written across the screen and is truncated at the right edge of 
the specified rectangle. The pattern will also be truncated at the bottom of the 
rectangle if needed. 

(continued) 


TI-83 Plus Developer Guide 


5-29 


Third Release January 25, 2002 


System Routines — Graphing and Drawing 


FillRectPattern (continued) 




Example: b_call 

ClrLCDFull 

r 

Clear the whole screen 

LD 

A, 6 

r 

Pattern is 6 pixels 



r 

high 

LD 

(RectFillPHeight) , 

7\ 



LD 

A, 4 

r 

Pattern is 4 pixels 



r 

wide 

LD 

(RectFillPWidth) , A 



LD 

HL, MyPattern 

r 

Copy source is the 



r 

pattern in this code 

LD 

DE, RectFillPattern 

r 

Copy destination is the 



r 

pattern buffer 

LD 

BC, 6 

r 

Copy 6 bytes 

LDIR 


r 

Copy pattern to pattern 



r 

buffer 

LD 

HL, lF2Fh 



LD 

DE, 3F5Eh 

r 

Coordinates of the full 



r 

screen except last 



r 

column 

B_CALL 

FillRectPattern 

r 

Fill it with the 



r 

pattern 

B_CALL 

GetKey 

r 

Get key press 

B JUMP 

JForceCmdNoChar 

r 

Exit app 

MyPattern: DB 

OFh, 07h, 03h, Olh, 

03h, 07h 
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GrBufClr 


Category: 
Description: 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 


Graphing and Drawing 

Clears out the graph backup buffer plotSScreen. 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


None 

All 768 bytes of plotSScreen set to 0. 
All 
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GrBufCpy 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Graphing and Drawing 

Copies the graph backup buffer plotSScreen to the display. 

None 

None 

(winBtm) should be = 8 

None 

None 

Graph buffer sent to display. 

All 

Both vertical and horizontal split setting will affect what is copied to the screen. 

See ForceFullScreen. See RestoreDisp. 


Example: 
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GrphCirc 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 


Others: 


Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Graphing and Drawing 

Draws a circle on the screen given the pixel coordinates of the center and a 
point on the circle. 


None 

useFastCirc, (IY + plotFlag3) = 1 for fast circle routine that draws the circle in 

sections simultaneously 

useFastCirc, (IY + plotFlag3) = 0 for normal circle routine that draws in a 

circular direction 

plotLoc, (IY + plotFlags) = 1 to draw to the display only 
plotLoc, (IY + plotFlags) = 0 to draw to display and buffer 
bufferOnly, (IY + plotFlag3) = 1 to draw to buffer only. 

Pixel coordinates for the center and a point on the circle. Coordinate (0,0) is 
the pixel in the lower left corner of the display, (x,y). 

(curGX2) = x coordinate of center 
(curGY2) = y coordinate of center 

(curGX) = x coordinate of point on the circle 
(curGY) = y coordinate of point on the circle 


None 

None 

Circle drawn on the display. 
All 


The graph screen does not have to be displayed. The current window settings 
have no affect. If useFastCirc is used, the flag must be reset by the caller. See 

CircCmd and DrawCirc2 routines. 


Example: 
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HorizCmd 

Category: Graphing and Drawing 

Description: Displays the current graph screen and draws a horizontal line at X = OP1 . 

Same as TI-83 Plus instruction Horizontal. 

Inputs: 

Registers: None 

Flags: graphDraw, (IY + graphFlags) = 1 if current graph is dirty, and needs to be 



redrawn 

= 0 if graph buffer is up to date and is copied to 
the screen. 

Others: 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

OP1 = X value to draw the horizontal line at. 


Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Current graph and the line are drawn to the screen and the graph backup 
buffer, plotSScreen. 

FPST = name of equation drawn, this must be cleaned by the calling routine. 

All 

RAM used: 

Remarks: 

OP1 -OP6 

Example: 

Draw a horizontal line at X = 3 on the graph screen. 


B_CALL OP 1 Set 3 ; OP1 = 3 


r 

B_CALL HorizCmd ; draw the line 
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IBounds 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Graphing and Drawing 

Tests if a pixel coordinate lies within the graph window defined by the current 
split mode settings. 


B = X pixel coordinate 
C = Y pixel coordinate 

The current split screen setting. 

None 


None 

CA = 1 if out of graph window 
= 0 if in graph window 

Line drawn where specified. 

All registers are preserved. 

G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. See 
ForceFullScreen and IBoundsFull routines for further information. 
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IBoundsFull 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Graphing and Drawing 

Tests if a pixel coordinate lies within the full pixel range of the display. Full 
screen mode should be active when using this routine. Valid values will include 
all 64 rows and 96 columns of the display. Normally only 63 rows and 95 
columns are valid. 


B = X pixel coordinate 
C = Y pixel coordinate 

The current split screen setting. 

None 


None 

CA = 1 if out of graph window 
= 0 if in graph window 

Line drawn where specified. 

All registers are preserved. 


G-T and FIORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. See the 
ForceFullScreen and IBounds routines for further information. 
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ILine 

Category: 

Description: 

Inputs: 


Registers: 


Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


Graphing and Drawing 

Draws a line between two-pixel points defined by their pixel coordinates. 

The line drawn can be on, off, or inverted. 

The graph window is defined with the lower left corner of the display to be pixel 
coordinates (0,0). 

The system graphing routines do not normally draw in the last column and the 
bottom row of the screen, column 95 and row 0. 

This routine can be made to use column 95 and row 0 by setting the flag: 
fullScrnDraw, (IY + apiFlg4) 

X = column 
Y = row 


B — X Coordinate of first point — 0...94 (95) see above 
C — Y Coordinate of first point — 1 (0)...63 
D — X Coordinate of second point — 0...94 (95) 

E — Y Coordinate of second point — 1 (0)...63 


H — Type of line to draw 

0 — Set points to light, on-line 

1 — Set points to dark 

2 — Invert points (XOR operation) 


fullScrnDraw, (IY + apiFlg4) 
plotLoc, (IY + plotFlags) 

bufferOnly, (IY + plotFlag3) 
None 


1 to use column 95 and row 0 
1 to draw to the display only 

0 to draw to display and plotSScreen buffer 

1 to draw to plotSScreen buffer only 


None 

None 

Line drawn where specified. 
All registers are preserved. 


(continued) 
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ILine (continued) 

Remarks: If the draw is going to the buffer, then the contents of the buffer are used to 

draw the line and copied to the screen. 

G-T and HORIZ split-screen modes affect how this routine maps the 
coordinates specified. To avoid this, turn off the split-screen modes. 

See ForceFullScreen. 

No clipping, X, Y points assumed to be defined on the screen. 

Example: Erase a line in the display only, between pixel coordinates (25,30) and (62,50). 


LD 

BC, 25*256+30 

; 1st point, B=25, 

; C=30 

LD 

DE , 62*256+50 

; 2nd point, D=62, 

; E=50 

SET 

plotLoc, ( IY+plotFlags ) 

; display only 

LD 

H, 0 

; signal turn pixels 
; off 

B_CALL 

ILine 

; draw the line 
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InvCmd 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Graphing and Drawing 

Displays the current graph screen and draws a function along the Y-axis. 

The equation is evaluated with respect to X, but the value of X will range 
between Ymin and Ymax, and the result of each evaluation will be the X 
coordinate, and the Y coordinate will be the value of X. It is the same as 
switching X and Y, and having Y be the independent variable. But it is 
important to write the expression in terms of X. 

Same as TI-83 Plus instruction Drawlnv. 


None 

graphDraw, (IY + graphFlags) = 1 if current graph is dirty and needs to be 

redrawn 

= 0 if graph buffer is up to date and is copied 
to the screen 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

FPST = name of equation to evaluate and draw 


None 

None 

Current graph and function are drawn to the screen and the graph backup 
buffer, plotSScreen. 

FPST = name of equation drawn, this must be cleaned by the calling routine. 
All 

OP1 - OP6 

Errors can be generated during the draw — see Error Plandlers section. 

See section on Floating Point Stack. 

Draw Y1 on the graph screen along the Y-axis. 


LD 

HL, Ylname 




B_ 

CALL 

Mov9ToOPl 

; OP1 = 

Y1 


B_ 

CALL 

PushRealOl 

; push 

Y1 into 

FPST 

B_ 

CALL 

InvCmd 

; draw 



B_ 

CALL 

PopRealOl 

; clean 

Y1 off 

of FPS 
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InvertRect 


Category: Graphing and Drawing 

Description: Inverts a rectangular area on the screen (black pixels to white; white pixels to 

black). 

Inputs: 

Registers: H = upper left corner pixel row 

L = upper left corner pixel column 
D = lower right corner pixel row 

E = lower right corner pixel column 

Flags: None 

Others: plotLoc, (IY + plotFlags): 

0: update display and graph buffer 
1 : update display only 

Outputs: 

Registers: None 


Flags: None 

Others: None 


Registers None 
destroyed: 

Remarks: Rectangle is defined by pixel coordinates, where row = 0, column = 0 is the 

upper left corner of screen and row = 63, column = 95 is the lower right corner 
of screen. 


Example: 


Area includes row and column of both coordinates. 


Inputs must satisfy conditions: D H, E 
Modifies saveSScreen RAM area. 


B_CALL 

ClrLCDFull 

LD 

HL, 0 

LD 

DE, 3F5Fh 

B_CALL 

InvertRect 

LD 

HL, 2030h 

LD 

DE, 3F5Fh 

B_CALL 

InvertRect 

B_CALL 

GetKey 


L. 


; Clear the screen 
; HL = upper left corner 
; DE = lower right corner 
; Blacken entire screen 
; HL = middle of screen 
; DE = lower right corner 
; Whiten lower right quadrant 
; Get key press 
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lOffset 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Graphing and Drawing 

Given a pixel location, computes the offset to add to the start address of the 
graph buffer to the byte in the buffer containing that pixel. 

Also returns the bit number in that byte for that pixel. 

Also computes the row and column commands to set the LCD driver to the 
display byte for that pixel. 


Pixel’s row and column coordinate, (0,0) = lower left pixel of the display. 
B — Column coordinate value, (0 - 95) 

C — Row coordinate value, (0 - 63) 

None 

None 


ACC = bit that corresponds to the pixel’s location in the byte it resides in is set. 
For example, pixel (0,0) would return with ACC = 80h, bit 7 is set. 

HL = byte offset to add to the start address of the display buffer to the byte 
that contains the pixel’s bit. 

(curXRow) = row command to send to the LCD driver for that pixel. 

(curY) = column command to send to the LCD driver for that pixel. 

None 

None 

All but DE 


3,14) is 

set in the graph buffer plotSScreen. 

LD 

BC, 23*256+14 

; BC = 23, 14 

B_CALL 

IOf f set 


LD 

DE, plotSScreen 

; start of graph buffer 

ADD 

HL, DE 

; add offset to byte with 
; pixel 

AND 

(HL) 

; and pixels bit with byte 
; in buffer 

JR 

Z , Pixel_is_Of f 

; jump if pixel is not set 
; in buffer 
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IPoint 

Category: 

Description: 


Inputs: 


Registers: 


Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


Graphing and Drawing 

Executes one of the following pixel operations without displaying the current 
graph screen: 

Turn Off 
Turn On 
Change (invert) 

Test 

Copy 

The pixels are addressed with the lower left corner of the display being pixel 
(0,0), (row, col) 

The system does not normally draw in the last column, and the bottom row of 
the screen, column 95 and row 0. 

This routine can be made to use column 95 and row 0 by setting the flag: 
fullScrnDraw, (IY + apiFlg4) 

B = pixel row address — 0...94 (95 if full screen) see above 
C = Y Coordinate of first point — 1 (0)...63 (64 if full screen) 

D = Function to perform 

0 — Turn point off 

1 — Turn point on 

2 — Invert point (XOR operation) 

3 — Test point 

4 — Copy a point from buffer to the display 

fullScrnDraw, (IY + apiFlg4) = 1 to use column 95 and row 0 

plotLoc, (IY + plotFlags) = 1 to draw to the display only 
plotLoc, (IY + plotFlags) = 0 to draw to display and buffer 

bufferOnly, (IY + plotFlag3) = 1 to draw to buffer only 

None 


None 

For option 3 (test) 

Z = 1 for point off 
Z = 0 for point on 

None 

None, except for option 3 (test) then all. 

(continued) 
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IPoint 

Remarks: 


Example: 


(continued) 

The test option always tests the buffer not the display. This means that in 
order to use the test option the pixel tested must have been written to the 
graph buffer. 

If the buffer is specified then the contents of the buffer are used to draw/copy, 
not what is in the screen. 

G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this turn off the split screen modes. See 

ForceFullScreen. 

If G-T mode is set then this routine will turn on pixels if the display byte 
containing the center column of pixels is accessed. This is done to keep the 
center line in G-T drawn. 

Turn on the point specified by pixel coordinates at (5,10). 


LD 

BC, 5*256+10 


LD 

D, 1 

; point on cmd 

B_CALL 

IPoint 

; turn on the point 
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LineCmd 


Category: 

Graphing and Drawing 

Description: 

Displays the current graph screen and draws a line defined by two points. 

These points are graph coordinates with respect to the current range settings. 
They do not have to be points on the screen. If they are not on the screen the 
line will still be drawn if it passes through the screen with the current range 
settings. 

Same as TI-83 Plus instruction Line(. 

Inputs: 

Registers: 

None 

Flags: 

graphDraw, (IY + graphFlags) = 1 if current graph is dirty and needs to be 

redrawn 

= 0 if graph buffer is up to date and is copied to 
the screen 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

Others: 

points (XI , Y1 ) (X2, Y2), all are floating-point numbers 

FPST = Y2 COORDINATE 

FPS1 = X2 COORDINATE 

FPS2 = Y1 COORDINATE 

FPS3 = XI COORDINATE 

See Floating Point Stack section. 

Outputs: 

Registers: 

None 

Flags: 

None 

Others: 

Current graph and line are drawn to the screen and the graph backup buffer, 

plotSScreen. 

Inputs are removed from the Floating Point Stack. 

Registers 

All 

destroyed: 

RAM used: 

OP1 -OP6 

Remarks: 

Errors can be generated during the draw. See Error Plandlers section. See 
CLine and ILine to draw lines without graphing. See section on Floating Point 
Stack. 


(continued) 
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LineCmd 

Example: 


(continued) 


Draw a line on the current graph screen between (1 ,2) and (3,4) 


B_CALL 

OPISetl 

; OP1 = XI 


B_CALL 

PushRealOl 

; to FPS 


B_CALL 

Plusl 

; OP1 = OP1 + 

1 

B_CALL 

PushRealOl 

; to FPS 


B_CALL 

Plusl 

; OP1 = OP1 + 

1 

B_CALL 

PushRealOl 

; to FPS 


B_CALL 

Plusl 

; OP1 = OP1 + 

1 

B_CALL 

PushRealOl 

; to FPS 


B_CALL 

LineCmd 

; copy graph 
; draw line 

to 


= Y1 


= X2 


= Y2 


screen 


and 
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PDspGrph 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Graphing and Drawing 

Tests if the graph of the current mode needs to be regraphed. If so, the graph 
is regraphed, otherwise copies plotSScreen to the display. 


None 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

Current graph window settings and equations 


None 

None 

None 

All 


G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this situation, turn off the split screen modes. 
See the ForceFullScreen routine for further information. 

Generate the current graph screen in the display. 

B_CALL PDspGrph 
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PixelTest 

Category: 

Description: 

Inputs: 


Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Graphing and Drawing 

Tests a pixel in the graph buffer specified by pixel coordinates without copying 
the graph to the display. 

Pixel coordinate (0,0), (row, col), is the upper left most pixel. 

FPST = Pixel coordinate’s column value, a floating-point number 
(0 - 94) in full screen and horizontal split 
(0 - 46) in vertical split 

FPS1 = Pixel coordinate’s row value, a floating-point number 
(0 - 62) in full screen 
(0 - 30) in horizontal split 
(0 - 50) in vertical split 

See Floating Point Stack section. 

None 

None 

None 


None 

Z = 1 for point off 
Z = 0 for point on 

None 

All 


Test on the point specified by pixel coordinates at (5,10). 

LD BC, 5*256+10 

r 

B_CALL PixelTest ; test the point 
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PointCmd 


Category: 

Description: 

Graphing and Drawing 

Displays the current graph screen and executes one of the following point 
operations: 

Turn Off 

Turn On 

Change (invert) 

The point is defined by graph coordinates with respect to the current range 
settings. The point does not need to be on the screen, and if it is not, then 
nothing will be drawn. 

Same as TI-83 Plus instructions Pt-On(, Pt-Off(, Pt-Change(. 


Inputs: 

Registers: ACC = point command 
0 = On 


Flags: 

1 = Off 

2 = Change 

graphDraw, (IY + graphFlags) = 1 if current graph is dirty and needs to be 

redrawn 

= 0 if graph buffer is up to date and is copied to 
the screen 

Others: 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

Bit 5 of RAM location (OP1 + 2) MUST = 0 

FPST = Y coordinate of the point, a floating-point number 

FPS1 = X coordinate of the point, a floating-point number 


Outputs: 

Registers: None 
Flags: None 


Others: 

Current graph and point operation are drawn to the screen and the graph 
backup buffer plotSScreen. 

Inputs are removed from the Floating Point Stack. 

Registers 

destroyed: 

RAM used: 

All 

OP1 -OP6 

Remarks: 

Errors can be generated during the draw. See Error Plandlers section. See 
CPoint, CPointS, and IPoint for point commands without graphing. 

(continued) 
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PointCmd (continued) 

Example: Invert point at coordinate (1 .5,2) 


LD 

HL, fp_lp5 

r 

B_CALL 

Mov9ToOPl 

; OP1 = X coordinate, 1.5 

B_CALL 

PushRealOl 

; to FPS 

B_CALL 

OPlSet2 

; OP1 = Y coordinate, 2, re 
; bit 5 (OP1 + 2) 

B_CALL 

PushRealOl 

; to FPS 

LD 

A, 2 

; command to invert 

B_CALL 

PointCmd 

; copy graph to screen and 
; invert point 


TI-83 Plus Developer Guide 


5-49 


Third Release January 25, 2002 


System Routines — Graphing and Drawing 


PointOn 

Category: 

Description: 

Inputs: 


Registers: 


Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Graphing and Drawing 

Turns on a point specified by its pixel coordinates. 

The graph window is defined with the lower left corner of the display to be pixel 
coordinates (0,0). 

The system graphing routines do not normally draw in the last column and the 
bottom row of the screen, column 95 and row 0. 

This routine can be made to use column 95 and row 0 by setting the flag: 
fullScrnDraw, (IY + apiFlg4) 

X = column 
Y = row 


B — X Coordinate of first point — 0...94 (95) see above 
C — Y Coordinate of first point — 1 (0)...63 


fullScrnDraw, (IY + apiFlg4) 
plotLoc, (IY + plotFlags) 

bufferOnly, (IY + plotFlag3) 


1 to use column 95 and row 0 
1 to draw to the display only 

0 to draw to display and plotSScreen buffer 

1 to draw to plotSScreen buffer only 


None 


None 

None 

None 

D 

If the buffer is specified, then the contents of the buffer are used to draw the 
point. 

G-T and FIOFtIZ split-screen modes affect how this routine maps the 
coordinates specified. To avoid this, turn off the split-screen modes. 

See ForceFullScreen. 

Turn on the point specified by pixel coordinates at (5,10): 

LD BC, 5*256+10 

r 

B_CALL PointOn ; turn on the point 
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Regraph 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Graphing and Drawing 

Graphs any selected equations in the current graph mode along with any 
selected statplots. 


None 


smartGraphJnv, (IY + smartFlags) = 1 to defeat smart regraphing feature 

and force all equations to be 
regraphed, not just new ones. 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, 

not to the display. 


Current graph equations 
Current window settings 


None 

None 

Graph redrawn to the display and backup buffer plotSScreen, or the 
plotSScreen only. 

All but AF 


G-T and FIORIZ split screen modes will affect how this routine maps the 
coordinates specified. . To avoid this situation, turn off the split screen modes. 
See the ForceFullScreen routine for further information. Also, see the Smart 
Regraphing section. 

B_CALL Regraph 
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SetAIIPIots 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Graphing and Drawing 
Selects or deselects all statplots. 

B = 0 to unselect 
B = 1 to select 

None 

None 

None 

None 

If any plot’s selection stat changes then the graph is marked dirty. 
All 


Turn off all stat plots. 

LD B, 0 

B_CALL SetAIIPIots 
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SetFuncM 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Graphing and Drawing 

Changes from current graph mode to function mode. 

None 

None 

None 

None 

None 

Current flags saved with current mode, function mode flags and pointers set 
up. 

A, BC, DE, HL 


B_CALL SetFuncM 
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SetParM 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


Graphing and Drawing 

Changes from current graph mode to parametric mode. 

None 

None 

None 

None 

None 

Current flags saved with current mode. Parametric mode flags and pointer set 
up. 

A, BC, DE, HL 


Remarks: 

Example: b_call SetParM 
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SetPolM 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


Graphing and Drawing 

Changes from current graph mode to polar mode. 

None 

None 

None 

None 

None 

Current flags saved with current mode, polar mode flags and pointers set up. 
A, BC, DE, HL 


Remarks: 

Example: b_call setPoiM 
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SetSeqM 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


Graphing and Drawing 

Changes from current graph mode to sequence mode. 

None 

None 

None 

None 

None 

Current flags saved with current mode, sequence mode flags and pointers set 
up. 

A, BC, DE, HL 


Remarks: 

Example: b_call setseqM 
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SetTbIGraphDraw 


Category: 

Description: 

Graphing and Drawing 

Sets the current graph to dirty to cause a complete regraph the next time the 
graph needs to be displayed. Also marks the table of values as dirty, unless a 
graph is currently being graphed. 


inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: smartGraphJnv, (IY + smartFlags) is set to invalidate smart graph 


Others: 

reTable, (IY + tbIFIags) is set to dirty the table, if not graphing 
graphDraw, (IY + graphFlags) is set to dirty the graph 

None 

Registers 

destroyed: 

Remarks: 

Example: 

None 
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TanLnF 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 


Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Graphing and Drawing 

Draws the tangent line for given equation at a given point. 

The equation itself is not drawn only the tangent line. 

The graph screen is not displayed — it is assumed to be displayed already. 


None 

None 

FPST = equation name, X is the independent variable 

Variable X = X coordinate of point 

OP1 = Y coordinate of point, a floating-point number 

Window settings for the current graph are used 


None 

None 

Tangent line drawn to the display. 

Equation name removed from the FPS. 

All 

OP1 - OP6 

See section on the Floating Point Stack in Chapter 2. 
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UCLineS 

Category: 

Description: 


Inputs: 

Registers: 


Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Graphing and Drawing 

Draws a WHITE line between two points specified by graph coordinates. 

The line is plotted according to the current window settings Xmin, Xmax, Ymin, 
Ymax. 


The points do not need to lie within the current window settings. This routine 
will clip the line to the screen edges if any portion of the line goes through the 
current window settings. 

This routine should only be used to draw lines in reference to the window 
settings. 

ILine can be used to draw lines by defining points with pixel coordinates, 
which will be a faster draw. 


FPS2 — Y1 Coordinate 
FPS3 — XI Coordinate 
FPS1 — Y2 Coordinate 
FPST — X2 Coordinate 

plotLoc, (IY + plotFlags) 


bufferOnly, (IY + plotFlag3) 


1 to draw to the display only 

0 to draw to the display and the plotSScreen 
buffer 

1 to draw to the plotSScreen buffer only 


G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. See the 

ForceFullScreen routine. 


grfSplit, (IY + sGrFlags) 
vertSplit, (IY + sGrFlags) 
grfSplitOverride, (IY + sGrFlags) 


1 if horizontal split mode set 
1 if graph-table split mode set 
1 to ignore split modes 


None 


None 

None 

None 

All 

OP1 - OP6 

This routine does not copy the graph buffer to the screen or invoke a regraph if 
needed. Use PDspGrph to make sure the graph in the screen is valid. 

See the CLineS routine. 
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UnLineCmd 


Category: 

Description: 

Graphing and Drawing 

Displays the current graph screen and erases a line defined by two points. 

These points are graph coordinates with respect to the current range settings. 
They do not have to be points on the screen. If they are not on the screen, the 
line will still be drawn if it passes through the screen with the current range 
settings. 

Same as the TI-83 Plus instruction Line( with the last argument = 0 for unline. 


Inputs: 

Registers: None 

Flags: graphDraw, (IY + graphFlags) = 1 if current graph is dirty and needs to be 


Others: 

redrawn 

= 0 if graph buffer is up to date and is copied to 
the screen 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

Points (X1,Y1) (X2,Y2), all are floating-point numbers 

FPST = Y2 COORDINATE 

FPS1 = X2 COORDINATE 

FPS2 = Y1 COORDINATE 

FPS3 = XI COORDINATE 

See the Floating Point Stack section. 


Outputs: 

Registers: None 
Flags: None 


Others: 

Current graph and line are drawn to the screen and the graph backup buffer, 

plotSScreen. 

Inputs are removed from the Floating Point Stack. 

Registers 

destroyed: 

RAM used: 

All 

OP1 -OP6 

Remarks: 

Errors can be generated during the draw — see the Error Plandlers section. 
See UCLineS to draw lines without graphing. See the Floating Point Stack 
section. 

Example: 

See LineCmd. 
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VertCmd 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Graphing and Drawing 

Displays the current graph screen and draws a vertical line at Y = OP1 . 
Same as TI-83 Plus instruction Vertical. 


None 

graphDraw, (IY + graphFlags) = 1 if current graph is dirty and needs to be 

redrawn 

= 0 if graph buffer is up to date and is copied to 
the screen 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

OP1 = Y value to draw the vertical line at 


None 

None 

Current graph and the line are drawn to the screen and the graph backup 
buffer, plotSScreen. 

FPST = name of equation drawn, this must be cleaned by the calling routine. 
All 

OP1 - OP6 


Draw a vertical line at Y = 3 on the graph screen. 


B_CALL 

OPlSet3 

; OP1 = 

= 3 

B_CALL 

VertCmd 

; draw 

the line 
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VtoWHLDE 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Graphing and Drawing 

In the current graph window converts a pixel point to its corresponding X and Y 
values, floating-point numbers. 

The graph must be up to date for this routine to return correct values. 

B = X pixel value, 0 - 94, 0 = left most pixel column 
C = Y pixel value, 1 - 62, 1 = next to last row of pixels from bottom 

None 

None 

None 

None 

OP1 = floating-point value representing X pixel coordinate 
OP4 = floating-point value representing Y pixel coordinate 

All 

OP1, OP2, OP3, OP4 

The bottom row of pixels is not used. Graph is up to date. 
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Xftol 

Category: 

Description: 


inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Graphing and Drawing 

In the current graph window, converts a floating-point value to an X pixel 
coordinate. 

This is used by the graphing routines to plot points in the current graph. 
The graph must be up to date for this routine to return correct values. 

HL = pointer to floating-point number representing the X coordinate 

None 

None 

ACC = X pixel value, 0 - 94, 0 = left most pixel column 

None 

None 

All 

OP1, OP2, OP3 

The right most column is not used. Graph is up to date. 
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Xitof 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Graphing and Drawing 

In the current graph window converts an X pixel coordinate to the floating-point 
value of X for that pixel. 

The graph must be up to date for this routine to return correct values. 

ACC = X pixel value, 0 - 94, 0 = left most pixel column 
HL = pointer to location to return floating-point value 

None 

None 

None 

None 

Floating-point value representing X pixel coordinate returned at input HL to 
HL + 8. 

All 

OP1, OP2, OP3 

The bottom row of pixels is not used. Graph is up to date. 
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Yftol 

Category: 

Description: 


inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Graphing and Drawing 

In the current graph window, converts a floating-point value to an Y pixel 
coordinate. 

This is used by the graphing routines to plot points in the current graph. 
The graph must be up to date for this routine to return correct values. 

HL = pointer to floating-point number representing the Y coordinate 

None 

None 

ACC = Y pixel value, 1 - 62, 1 = next to last row of pixels from bottom 

None 

None 

All 

OP1, OP2, OP3 

The bottom row of pixels is not used. Graph is up to date. 
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ZmDecml 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Graphing and Drawing 

Changes the window settings such that (0,0) is in the center of the display and 
sX and =Y = 0.1 . See the ZDecimal selection in the TI-83 Plus ZOOM menu. 

None 

None 

Current window settings. 

None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 

Current window settings are moved to ZPrevious. New windows settings set to 
X: -4.7 to 4.7, Y: -3.1 to 3.1 

All 

The graph is marked dirty for redrawing, but the graph is not redrawn. 
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ZmFit 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

Remarks: 

Example: 


Graphing and Drawing 

Changes the window settings such that the minimum and maximum Y value 
for all selected functions fit in the graph window. 

The same ZoomFit under the ZOOM menu. 

None 

None 

Current window settings 

None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 

Current window settings are moved to ZPrevious. 

New windows settings set so that all selected functions Y values fit in the 
display when regraphed. 

All 

The graph is marked dirty for redrawing, but the graph is not redrawn. 
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Zmlnt 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 


Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

Remarks: 

Example: 


Graphing and Drawing 

Changes the window settings such that AX and AY = 1 .0, given the 
coordinates in the center of the screen. The coordinates of the center of the 
screen are rounded to the closest integer before the window range is set. See 
the Zlnteger selection in the TI-83 Plus ZOOM menu. 


None 

None 

OP1 = X coordinate of new center of the screen, floating-point number 
OP5 = Y coordinate of new center of the screen, floating-point number 

Current window settings. 


None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 
Current window settings are moved to ZPrevious. 

New windows settings set. 

All 

The graph is marked dirty for redrawing, but the graph is not redrawn. 
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ZmPrev 

Category: 

Description: 


inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Graphing and Drawing 

Changes the window settings back to the settings before the last zoom 
command was executed, if one was. See the ZPrevious selection in 
TI-83 Plus ZOOM/MEMORY menu. 

None 

None 

None 

None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 

If ZPrevious values exist they are copied to the current window settings. 

All 

The graph is marked dirty for redrawing, but the graph is not redrawn. 
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ZmSquare 


Category: 

Description: 


inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Graphing and Drawing 

Changes the window settings in either the X or Y direction such that AX = AY. 
Doing this operation will make a circle drawn have the shape of a circle instead 
of an ellipse. See the ZSquare selection in the TI-83 Plus ZOOM menu. 

None 

None 

None 

None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 
Current window settings are moved to ZPrevious. 

New windows settings set. 

All 

The graph is marked dirty for redrawing, but the graph is not redrawn. 
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ZmStats 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Graphing and Drawing 

Changes the window settings such that all selected Statplots will be visible in 
the graph window. See the ZoomStat in the TI-83 Plus ZOOM menu. 

None 

None 

None 

None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 
Current window settings are moved to ZPrevious. 

New windows settings set. 

All 

The graph is marked dirty for redrawing, but the graph is not redrawn. 
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ZmTrig 

Category: 

Description: 


inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

Remarks: 

Example: 


Graphing and Drawing 

Changes the window settings to preset values that are appropriate for 
trigonometrical function graphs. See the ZTrig selection in the TI-83 Plus 
ZOOM menu. 


None 

None 

Current window settings 


None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 

Current window settings are moved to ZPrevious. 

New windows settings set to X: -(47/24) * pi, Y: (47/24) * pi 

If the current angle mode setting is radians, then those values are used. If the 
current angle mode setting is degrees, then those values are converted from 
radians to degrees. 

All 

The graph is marked dirty for redrawing, but the graph is not redrawn. 
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ZmUsr 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Graphing and Drawing 

Recalls the window settings stored by the last ZoomSto command. See the 
ZoomRcl selection in the TI-83 Plus ZOOM/MEMORY menu. 

None 

None 

None 

None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 
Current window settings are moved to ZPrevious. 

New windows settings set. 

All 

The graph is marked dirty for redrawing, but the graph is not redrawn. 
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ZooDefault 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Graphing and Drawing 

Changes the window settings back to the default settings of (-10,10) for both X 
and Y ranges. 

The same ZStandard under the ZOOM menu. 

None 

None 

Current window settings 

None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 
New windows settings set to X: -1 0 to 10, Y: -1 0 to 10 
All 

The graph is marked dirty for redrawing, but the graph is not redrawn. 
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System Routines — 
Interrupt 


DivHLBylO 
DivHLByA . 


6-1 

&2 
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DivHLBylO 

Category: Interrupt 

Description: Divides HL by 10. 

Inputs: 

Registers: HL = dividend 
Flags: None 

Others: None 

Outputs: 

Registers: HL = lnt(HL/10) 

A = mod(HL/10) 

Flags: None 

Others: None 

Registers None 

destroyed: 

Remarks: None 

Example: 
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DivHLByA 

Category: Interrupt 

Description: Divides HL by accumulator. 

Inputs: 

Registers: HL = dividend 
A = divisor 

Flags: None 

Others: None 

Outputs: 

Registers: HL = lnt(HL/A) 

A = mod(HL/A) (remainder) 

Flags: None 

Others: None 

Registers None 

destroyed: 

Remarks: None 

Example: 
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System Routines — 

10 


AppGetCalc |7-l| 

AppGetCbl |7-2| 


RecIstByte 3 

RecIstByteNC 


RecABytelO 7-5 


SendAByte [7J3 

SendVarCmd 


7-7 
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AppGetCalc 


Category: 10 

Description: Executes the basic GetCalc command to retrieve a variable from another 

TI-83 Plus or a Tl— 83. 


Inputs: 

Registers: 0P1 = name of variable to attempt to retrieve 
Flags: None 

Others: None 


Outputs: 

Registers: None 
Flags: None 

Others: comFailed, (IY + getSendFIg) = 0 if variable received 

comFailed, (IY + getSendFIg) = 1 if variable not received 
Variable updated or created if received 

Registers All 

destroyed: 


Remarks: Variables can be received from both an TI-83 Plus and a TI-83. 


Example: 

B_CALL 

AnsName 

; OP1 = Ans 


B_CALL 

AppGetCalc 

; variable name 
; attempt to get 


BIT 

comFailed, ( IY+getSendFlg) 

; Ans 

; did it work? 


JP 

NZ, GetFailed 

; jump if no 
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AppGetCbl 


Category: 

10 


Description: 

Executes the basic GetCbl command to retrieve data from a CBL/CBL2 or 
CBR device. 

Inputs: 



Registers: 

OP1 = name of variable to attempt to retrieve 


Flags: 

None 


Others: 

None 


Outputs: 



Registers: 

None 


Flags: 

None 


Others: 

comFailed, (IY + getSendFIg) = 0 if variable received 
comFailed, (IY + getSendFIg) = 1 if variable not received 
Variable updated or created if received 


Registers 

destroyed: 

All 


Remarks: 



Example: 

LD HL, Llname 

RST rMov9ToOP 1 ; 

r 

B_CALL AppGetCbl ; 

r 

BIT comFailed, ( IY+getSendFlg) ; 

JP NZ , GetFailed 

Llname: DB ListOb j , tVarLst , tLl , 0, 0 

OP1 = LI variable 

name 

attempt to get 

data 

did it work? 
jump if no 
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RecIstByte 


Category: 

Description: 


inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


10 

Polls the link port for activity until either a byte is received, the [ON] key is 
pressed, or an error occurred during communications. The cursor is turned on 
for updates. 


None 

None 

None 


ACC = byte received if one 
None 

Error will be generated if communications fail. 

An error is also generated if the [ON] key is pressed. 

All 


APD can occur while waiting for link activity. See Chapter 2 for Error Handlers 
and Link Port. See entry points RecIstByteNC, RecAByte, and SendAByte. 

See Chapter 2. 
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RecIstByteNC 


Category: 

Description: 


inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


10 

Polls the link port for activity until either a byte is received, the [ON] key is 
pressed, or an error occurred during communications. The cursor is not turned 
on for updates. 


None 

None 

None 


ACC = byte received if one 
None 

Error will be generated if communications fail. An error is also generated if the 
[ON] key is pressed. 

All 


APD can occur while waiting for link activity. See Chapter 2 for Error Handlers 
and Link Port. See entry points RecIstByte, RecAByte, and SendAByte. 

See Chapter 2. 
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RecABytelO 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


10 

Attempts to read a byte of data over the link port. 

None 

None 

None 

ACC = byte if successful 

None 

None 

All 

If no link activity is detected within about 1 .1 seconds, a system error is 
generated. See entry points RecIstByte, RecIstByteNC, and SendAByte. 

See Chapter 2. 
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SendAByte 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


10 

Attempts to send a byte of data over the link port. 

ACC = byte to send. 

None 

None 

None 

None 

None 

All 

If no link activity is detected within about 1 .1 seconds, a system error is 
generated. See entry points RecIstByte, RecIstByteNC, and RecAByte. 

See Chapter 2. 
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SendVarCmd 

Category: 10 

Description: Attempts to send a variable whose name is in 0P1 to CBL/CBL2 or CBR 

device. 

Inputs: 

Registers: None 

Flags: None 

Others: 0P1 contains name of variable to send. 

Outputs: 

Registers: None 

Flags: ComFailed, (lY+getSendFIg) = 1 if send failed. 

ComFailed, (lY+getSendFIg) = 0 if successful. 

Others: 0P1 is left intact. 

Registers All 

destroyed: 

Remarks: No system error is generated if link is not successful. 

Example: Check status of Channel 1 on CBL2. 



LD 

HL, Llname 




RST 

rMov9ToOPl 

t 

0P1 = LI name 


RST 

rFindSym 

t 

Look up LI 


JR 

C, Createlt 

t 

jump if it doesn't 




t 

exist 


B_CALL 

DelVarArc 

r 

delete LI 

Createlt : 

LD 

HL, 3 

t 

3 elements in LI 


B_CALL 

CreateRList 

t 

LI created 


INC 

DE 




INC 

DE 

t 

move past size bytes 


LD 

HL, Command8 




LD 

BC, 27 




LDIR 


t 

LI = {8,1,0} 


B_CALL 

0p4To0pl 

t 

OP1 = LI name 


B_CALL 

SendVarCmd 

t 

send LI to CBL2 


BIT 

ComFailed, (IY+getSendFlg) 

t 

did it work? 


JP 

NZ, SendFailed 

t 

no, jump 


B_CALL 

AppGetCbl 

t 

attempt to get LI 


BIT 

ComFailed, ( IY+getSendFlg) 

t 

did it work? 


JP 

NZ, GetFailed 

t 

jump if no 

Llname : 

DB 

Li st Ob j , tVarLst , tLl , 0, 0 



Command8 : 






DB 

OOh, 80h, 80h, OOh, OOh, 

OOh, OOh, OOh, OOh 


DB 

OOh, 80h, lOh, OOh, OOh, 

OOh, OOh, OOh, OOh 


DB 

OOh, 80h, OOh, OOh, OOh, 

OOh, OOh, OOh, OOh 
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System Routines — 
Keyboard 


ApdSetup... 

CanAlphlns 

GetCSC 

GetKey 


8-1 

8-2 

M 

F6 
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ApdSetup 

Category: Keyboard 

Description: Resets the Automatic Power Down timer. 

Inputs: 

Registers: None 

Flags: None 

Others: None 

Outputs: 

Registers: (apdTimer) 

Flags: None 

Others: None 

Registers HL 

destroyed: 

Remarks: 

Example: 
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CanAlphlns 

Category: Keyboard 

Description: Cancels alpha, alpha lock, and insert mode. 

Inputs: 

Registers: None 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: textlnsMode (In textFlags) and shiftALock (In shiftFlags) cleared 


Others: 

shiftAlpha (In shiftFlags) and shiftLwrAlph (In shiftFlags) may also be cleared 
depends on flag shiftKeepAlph (In shiftFlags) 

None 

Registers 

destroyed: 

None 

Remarks: 

Example: 

B_CALL CanAlphlns 
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Getcsc 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 


Registers: 

Flags: 

Others: 

Registers 

destroyed: 


Keyboard 

Gets and clears keyboard scan code. This routine should be used to read the 
keyboard only when an app does not care about second keys or alpha keys or 
pull down menus. 

This routine only returns to the application which physical key on the keyboard 
was last pressed. 


None 

None 

None 

This routine does not wait for a key press to return back to the app. Key 
presses are detected in the interrupt handler, this routine returns that value. A 
0 value is returned it no key has been pressed since the previous call to 

GetCSC. 

A = (kbdScanCode) value 
None 

(kbdScanCode) set to 0. kbdSCR flag reset. 

AF, HL 


(continued) 
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Getcsc (continued) 

Remarks: No silent link activity will be detected if this routine is used to poll for keys. 

Below are the scan code equates. 


skDown 

equ 

01 h 

skCos 

equ 

1 Eh 

skLeft 

equ 

02h 

skPrgm 

equ 

1 Fh 

skRight 

equ 

03h 

skStat 

equ 

20h 

skllp 

equ 

04h 

skO 

equ 

21 h 

skEnter 

equ 

09h 

ski 

equ 

22h 

skAdd 

equ 

OAh 

sk4 

equ 

23h 

skSub 

equ 

OBh 

sk7 

equ 

24h 

skMul 

equ 

OCh 

skComma 

equ 

25h 

skDiv 

equ 

ODh 

skSin 

equ 

26h 

skPower 

equ 

OEh 

skMatrix 

equ 

27h 

skClear 

equ 

OFh 

skGraphvar 

equ 

28h 

skChs 

equ 

1 1 h 

skStore 

equ 

2Ah 

sk3 

equ 

12h 

skLn 

equ 

2Bh 

sk6 

equ 

13h 

skLog 

equ 

2Ch 

sk9 

equ 

14h 

skSquare 

equ 

2Dh 

skRParen 

equ 

15h 

skRecip 

equ 

2Eh 

skTan 

equ 

16h 

skMath 

equ 

2Fh 

skVars 

equ 

17h 

skAlpha 

equ 

30h 

skDecPnt 

equ 

19h 

skGraph 

equ 

31 h 

sk2 

equ 

1 Ah 

skT race 

equ 

32h 

sk5 

equ 

1 Bh 

skZoom 

equ 

33h 

sk8 

equ 

ICh 

skWindow 

equ 

34h 

skLParen 

equ 

1 Dh 

skYEqu 

equ 

35h 




sk2nd 

equ 

36h 




skMode 

equ 

37h 




skDel 

equ 

38h 


(continued) 
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Getcsc (continued) 

Example: Poll tor the 2nd key. 

EI 


sleep : 


HALT 


B_CALL 

CP 

JR 


; enable interrupts 

; the halt is optional, this 
; will help save battery life. 

; you can still use GetCSC at 
; anytime without the halt. 


GetCSC 
ksk2nd 
NZ, sleep 


; sleep in low power for a 
; little 

; check for a scan code 
; 2nd key ? 

; jump if no 
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GetKey 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

Remarks: 

Example: 


Keyboard 

Keyboard entry routine that will return second keys, alpha keys — both capital 
and lower case, the on key, APD, and link communication. Contrast 
adjustment is also handled by this routine. 

When called, this routine scans for keys until one is pressed, or an APD 
occurs, or the unit is turned off, or link activity is detected. 


None 

indicOnly, (IY + indicFlags) 
indicRun, (IY + indicFlags) 
apdAble, (IY + apdFlags) 


MUST BE RESET, otherwise no key presses 
will be detected. 

1 to show the run indicator while waiting for a 
key press. 

1 if APD is enabled 
0 if APD is disabled 


IwrCase Active, (IY + appLwrCaseFlag) 


None 


1 for the key sequence 
[alpha] [alpha] to access lower 
case alpha key presses 
0 for normal alpha key operation 


ACC = key code, 0 = ON key 

See TI83plus.inc file. 

onlnterrupt, (IY + onFlags) = 1 if ON key, this should be reset 

APD: If the auto power down occurs the application will not be notified. Once 
the unit is turned back on control is returned to the GetKey routine. 

OFF: If the unit is turned off the application is put away. When the unit is 
turned back on the home screen will be in control. 

Link Activity: When link activity is initiated, control is given to the silent link 
handler. If the communication is from the GRAPPI LINK, the 
application will be shut down in most cases. The only exception is 
getting screen snap shots, in that case the application is not shut 
down. After the screen is sent control returns to GetKey. 

DE, HL 


If APD is disabled, it should be re-enabled before exiting the application. If 
lower case is enabled, it should be disabled upon exiting the application. 
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System Routines — 

List 


AdrLEIe 

ConvDim 

ConvLcToLr 

ConvLrToLc 

DelListEI 

Find_Parse_Formula . 

GetLToOPI 

IncLstSize 

IncLstSize (continued) 

InsertList 

InsertList (continued) .. 
PutToL 


.. 9-1 

..Wg 

,.9j3 

- M 

.. 9J3 

.. 9^7 

.. 9^8 

.. 9^9 

9^0 

9jT 

9-12 
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AdrLEIe 


Category: 

Description: 

Inputs: 

Registers: 


Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


List 

Computes the RAM address of an element of a list. 


DE = pointer to start of list’s data storage, output of FindSym 
HL = element number in list to compute address of. List element number one 
is checked for real or complex data type to determine if the list is real or 
complex. 

None 

None 


HL = pointer in RAM to the start of the desired element 

None 

None 

AF, BC 


This routine does not check to see if the element’s address requested is within 
the current size of the list. 

Do not use this routine on a list that does not have element number 1 
initialized. 


Compute the address of element number 23 of list LI . 


LD 

HL, LlName 


RST 

rMov9ToOPl 

; OP1 = LI name 

B_CALL 

FindSym 

; look it up 

JP 

C, Undef inedLl 

; jump out if LI is not 
; defined; 

LD 

A, B 

; if b<>0 then LI is archived 
; in Flash ROM 

OR 

A 


JP 

NZ , ArchivedLl 

; jump if not in RAM 


; DE = pointer to start of list data storage; 


LlName : 


LD 

B CALL 


RET 

DB 


HL, 23d 
AdrLEIe 


; element's address desired 
; RET HL = pointer to 23rd 
; element 


Li st Ob j , tVarLst , tLl , 0, 0 
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ConvDim 


Category: List 

Description: Converts floating-point value in OP1 to a two-byte hex value — make sure 

valid matrix or vec dimension. Less than 1 00 is valid dimension 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = FP number 

Outputs: 

Registers: A = LSB HEX VALUE, DE = ENTIRE HEX VALUE 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


None 

None 

A, BC, DE, HL, OP1 

Error if negative, non-integer, or greater than 99. 

B_CALL ConvDim 
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ConvLcToLr 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


List 

Converts an existing complex list variable to a real list variable. 

None 

None 

OP1 = name of complex list variable to convert 


None 

None 

Error if the list was undefined. 

OP1 = name of list with type set to ListObj. The imaginary part of each 

element is deleted and the data storage area is compressed. All symbol 
table pointers are updated. 


Registers All 
destroyed: 

Remarks: Do not use this routine if the input list is already a real list. 

Example: 
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ConvLrToLc 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

Remarks: 

Example: 


List 

Converts an existing real list variable to a complex list variable. 

DE = pointer to data storage for list, output of ChkFindSym 
None 

FPST = name of variable converted, see Floating Point Stack 


DE = pointer to data storage of converted list 
None 

Error if not enough free RAM to convert to complex. 

Each element of the list is converted to a complex number with a 0 imaginary 
part. 

FPST = name of variable converted, see Floating Point Stack. 

All symbol table pointers are updated. 

All 

Do not use this routine if the input list is already a complex list. 

Convert real list LI to a complex list. 


LD 

HL, LlName 



RST 

rMov9ToOPl 

r 

OPl = Ll name 

B_CALL 

PushRealOl 

r 

FPST = name of list 

B_CALL 

FindSym 

r 

r 

look it up, DE = pointer 
to data storage 

JP 

C, convertError 

r 

r 

jump out if Ll is not 
defined 

AppOnErr 

convertError 

r 

r 

install error handler in 
case not enough RAM 

B_CALL 

ConvLrToLc 

r 

r 

attempt to convert to 
complex 

AppOf fErr 


r 

r 

remove error handler, 
successful 

B_CALL 

PopRealOl 

r 

r 

remove name of list from 
FPST 

RET 





LlName : 

DB ListOb j , tVarLst , tLl , 0 , 0 


TI-83 Plus Developer Guide 


9-4 


Third Release January 25, 2002 


System Routines — List 


DelListEI 

Category: 

Description: 

Input: 

Registers: 


Flags: 

Others: 

Output: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


List 

Deletes one or more elements from an existing list, residing in RAM. 


A = ListObj if the list has real elements 
= CListObj if the list has complex elements 
DE = pointer to start of list’s data storage, output of FindSym 
HL = number of elements to delete 
BC = element number to start deleting at 

None 

None 


HL = pointer to start of list’s data storage, output of FindSym 
DE = new dimension of the list. 

None 

(insDelPtr) = pointer to start of the list 
All 

DO NOT ATTEMPT ON AN ARCHIVED LIST. The size bytes of the list are 
adjusted. All pointers in the symbol table are updated 

Delete three elements from list LI starting with element number two. 


LD 

HL, LIName 


RST 

rMov9ToOPl 

; OP1 = LI name 

B_CALL 

FindSym 

; look it up, DE = pointer 
; to data storage 

JP 

C, Undef inedLl 

; jump out if LI is not 
; defined 

LD 

C, A 

; save type 

LD 

A, B 

; get archived status 

OR 

A 

; in RAM or archived 

JP 

NZ, errArchived 

; cannot insert if archived 

LD 

A, C 

; get type back 

AND 

lFh 

; mask type of list in ACC 

LD 

HL, 3 

; want to delete 3 elements 

LD 

BC, 2 

; delete 2nd element on 

B_CALL 

DelListEI 

; delete elements 


LIName : 

DB ListObj , tVarLst , tLl , 0, 0 
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Find Parse Formula 


Category: List 

Description: Checks it a list variable has a formula attached to it and parses the formula 

and stores it back into the list data. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


None 

None 

OP1 = name of list 

None 

None 

If no error, then the list values are updated. 

All 

If no formula is attached, nothing is done to the existing list data. 

Any error that occurs during the parsing of the formula will cause an error 
screen to be displayed if no error handler is invoked. 

If the resulting type from the formula parsing is not a list, this will also generate 
an error. 

See Error Handlers. 


Example: 
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GetLToOPI 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


List 

Copies a list element to OP1 or OP1/OP2. 

HL = element number to copy 

DE = pointer to start of list’s data storage 

None 

None 

HL = pointer to next element in the list 
None 

OP1 = list element if a real list 
OP1/OP2 = list element if a complex list 


Registers All 
destroyed: 

Remarks: 

Example: 
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IncLstSize 


Category: List 

Description: Increments the size of an existing list in RAM by adding one element at the 

end of the list. No value is stored in the new element. 


Input: 


Registers: A 
DE 


ListObj if the list has real elements 

CListObj if the list has complex elements 

pointer to start of list’s data storage, output of FindSym 


Flags: None 


Others: None 


Output: 

Registers: DE = intact 

HL = new dimension of the list 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


None 

(insDelPtr) = pointer to start of the list 
All 

DO NOT ATTEMPT ON AN ARCHIVED LIST. A memory error will be 
generated if insufficient RAM. The size bytes of the list are adjusted. All 
pointers in the symbol table are updated. 

(continued) 
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IncLstSize (continued) 

Example: Increment real list LI and store a 3 in the new element. 



LD 

HL, LIName 




RST 

rMov9ToOPl 

r 

OPl = Ll name 


B_CALL 

FindSym 

r 

look it up, DE = pointer to 




r 

data storage 


JP 

C, Undef inedLl 

r 

jump out if Ll is not 




r 

defined 

r 

LD 

A, B 

r 

get archived status 


OR 

A 

t 

in RAM or archived 


JP 

NZ, errArchived 

r 

cannot insert if archived 

r 

LD 

A, ListOb j 

r 

type of list in ACC 

r 

B_CALL 

IncLstSize 

r 

insert element at end 

r 

PUSH 

DE 

r 

save pointer to list 


PUSH 

HL 

r 

save last element #, just 




r 

inserted 

r 

B_CALL 

OPlSet3 

r 

r 

OPl = 3 

r 

POP 

HL 




POP 

DE 

r 

restore 

r 

B_CALL 

PutToL 

r 

store OPl to inserted 




r 

element 

t 

LIName : 






DB 

ListOb j , tVarLst 

tLl, 0, 0 
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InsertList 

Category: 

Description: 

Inputs: 

Registers: 


Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


List 

Inserts one or more elements into an existing list, residing in RAM. 


A = ListObj if the list has real elements 

A = CListObj if the list has complex elements 

DE = pointer to start of list’s data storage, output of FindSym 

HL = number of elements to insert 

BC = List element number to insert after 

CA = 0 to set new elements to 0 
CA = 1 to set new elements to 1 

None 


DE = intact 

HL = new dimension of the list. 

None 

(insDelPtr) = pointer to start of the list 
All 

DO NOT ATTEMPT ON AN ARCHIVED LIST. A memory error will be 
generated if insufficient RAM. The size bytes of the list are adjusted. All 
pointers in the symbol table are updated 

(continued) 
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InsertList (continued) 


Example: 


Insert three new elements in list LI after its second element, set the new 
elements to 0’s. 


LD 

HL, LlName 


RST 

rMov9ToOPl 

; OP1 = LI name 

B_CALL 

FindSym 

; look it up, DE = pointer to 
; data storage 

JP 

C, Undef inedLl 

; jump out if LI is not 
; defined 

LD 

C, A 

; save type 

LD 

A, B 

; get archived status 

OR 

A 

; in RAM or archived 

JP 

NZ, errArchived 

; cannot insert if archived 

LD 

A, C 

; get type back 

AND 

lFh 

; mask type of list in ACC 

LD 

HL, 3 

; want to insert 3 elements 

LD 

BC, 2 

; insert after 2nd element 

OR 

A 

; CA = 0, to set new elements 
; to 0 

B_CALL 

InsertList 

; insert elements 


LlName : 

DB ListOb j , tVarLst , tLl , 0, 0 
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PutToL 


Category: List 

Description: Stores either a floating-point number or a complex pair to an existing element 

of a list. 

Inputs: 

Registers: HL = element number to store to 

There is no check to see if this element is valid for the list. 

DE = pointer to the start of the list’s data area, output of FindSym 

Flags: None 

Others: None 

OP1 = floating-point number set to RealObj to store to a real list 

OP1/OP2 = floating-point numbers representing a complex number to store to 
a complex list 

There are no checks made that the correct data type is being stored to the 
correct type of list (real/complex). 

Outputs: 

Registers: DE = pointer to next element in the list 

Flags: None 

Others: OP1/OP2 = intact 

Registers All 

destroyed: 

Remarks: 


Example: ; Look up LI and store 1 to element 30. 


LD 

HL, Llname 


B_CALL 

Mov9ToOPl 

; OP1 = name 

B_CALL 

FindSym 

; look up 

RET 

C 

; return if undefined 



; DE = pointer to data area 

PUSH 

DE 

; save pointer 

B_CALL 

OPISetl 

; OP1 = 1 

POP 

DE 


LD 

HL, 30d 

; element to store to 

B_CALL 

PutToL 

; store 1 to element 30 


RET 

r 

Llname : 

DB ListOb j , tVarLst , tLl , 0 
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System Routines — 
Math 
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CkOPI Real. 
CkOP2FPO . 
CkOP2Pos.. 
CkOP2Real. 

CkPosInt 

CkValidNum 

CLN 

CLog 

ClrLp 

ClrOPIS 

CMItByReal. 

CMult 

Conj 

COPISetO .. 

Cos 

CosH 

Cp0P10P2. 

Cp0P40P3. 

CRecip 

CSqRoot 

CSquare 

CSub 

CTenX 

CTrunc 

Cube 

CXrootY 

CYtoX 

DecOI Exp .. 

DToR 

EToX 

ExpToHex... 

Factorial 

FPAdd 


10-28 

10-29 

10-30 

10431 

10-32 

Td33~ 

10-34 

10435 

10436 
Td37 

Td38~ 

10439 

10-40 

Wa\ 

1042 

10-43 

10-44 

HM5 

10-46 

10-47 

TF48 

10-49 

10450 

10-51 

10432 
10-53 
10-54 
Td55~ 

10-56 

1d57 

10-58 

10439 

10430 


(continued) 
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FPDiv 

FPMult 

FPRecip 

FPSquare 

FPSub 

Frac 

PILTimes9 

FITimesL 

Int 

Intgr 

InvOPIS 

InvOPISC 

lnvOP2S 

InvSub 

LnX 

LogX 

Max 

Min 

Minusl 

OP1 ExpToDec 

OPISetO, OPISetl, OP1Set2, OP1Set3, OP1Set4, OP2SetO, OP2Set1, 
OP2Set2, OP2Set3, OP2Set4, OP2Set5, OP2Set60, OP3SetO, OP3Set1, 
OP3Set2, OP4SetO, OP4Set1 , OP5SetO 

OP2Set8 

OP2SetA 

Plusl 

PToR 

Randlnit 

Random 

RName 

RndGuard 

RnFx 

Round 

RToD 

RToP 


10-61 

10-62 

10-63 

T(H34 

10-65 

UH36 

10-67 

1^68 

UH39 

Wro 

Wn 

1072 

10-73 

10-74 

1~075 

10-76 

10-77 

10^78 

10-79 

10-80 


10-81 

10-82 

10-83 

10^84 

10-85 

TF86 

10-87 

1^88 

1^89 

HHIO 

UK)! 

10-92 

1^93 
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Abs0102Cp 


Category: Math 

Description: Compares Abs(OPI) to Abs(OP2). 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 

OP2 = floating point 


Outputs: 

Registers: None 

Flags: Z = 1 : Abs(OP1 ) = Abs(OP2) 

Z = 0, CA = 1 : Abs(OP1 ) < Abs(OP2) 

Z = 0, CA = 0: Abs(OP1 ) >= Abs(OP2) 

Others: OP1=Abs(OP1) 

OP2 = Abs(OP2) 

Registers A, BC, DE, HL 

destroyed: 


Remarks: None 

Example: 
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AbsOI PAbs02 


Category: Math 

Description: Calculates the sum of the absolute values of the floating point in OP1 plus the 

floating point in OP2. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 

OP2 = floating point 


Outputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point with value (Abs(OPI) + Abs(OP2)) 

Registers A, BC, DE, HL 

destroyed: 


Remarks: None 

Example: 
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ACos 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Computes the inverse cosine of a floating point. The answer will not go 
complex. 

None 

None 

OP1 = floating point 

None 

None 

OP1 = inverse cosine (floating point) 

All 

OP1, OP2, OP3, OP4, OP5 
Domain error if answer is complex. 
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ACosH 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Computes inverse hyperbolic cosine of a floating point. 

None 

None 

OP1 = floating point 

None 

None 

OP1 = inverse hyperbolic cosine (floating point) 

All 

OP1, OP2, OP3, OP4, OP5 
Domain error if OP1 is negative. 
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ACosRad 


Category: Math 

Description: Computes the inverse cosine of a floating point and force radian mode. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = inverse cosine (floating point) 

Registers All 
destroyed: 


RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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Angle 


Category: Math 

Description: Calculates a polar complex angle from a rectangular complex. 

Input: 

Registers: None 

Flags: None 

Others: OP1 = real representing complex X 

OP2 = real representing complex Y 


Outputs: 

Registers: None 
Flags: None 

Others: OP1 = real representing complex angle 

Registers All 

destroyed: 


Remarks: OP1 is not modified. 

Example: 
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ASin 


Category: Math 

Description: Computes the inverse sine of a floating point. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = inverse sine (floating point) 

Registers All 
destroyed: 


RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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ASinH 


Category: Math 

Description: Computes the inverse hyperbolic sine of a floating point. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = inverse sine (floating point) 

Registers All 
destroyed: 


RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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ASinRad 


Category: Math 

Description: Computes the inverse sine of a floating point and force radian mode. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = inverse sine (floating point) 

Registers All 
destroyed: 


RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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ATan 


Category: Math 

Description: Computes the inverse tangent of a floating point. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = inverse tangent (floating point) 

Registers All 
destroyed: 


RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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System Routines — Math 


ATan2 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 


Math 

Returns the angle portion of a complex number in rectangular form. 

None 

trigDeg, (IY + trigFlags) = 1 to return angle in degrees 

= 0 to return angle in radians 

OP1 = imaginary part of complex number, floating-point number 
OP2 = real part of complex number, floating-point number 


Outputs: 

Registers: None 
Flags: None 

Others: OP1 = the angle portion of the polar form of the input rectangular complex 

number. 


Registers All 
destroyed: 


RAM used: OP1 -OP5 

Remarks: 

Example: 
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System Routines — Math 


ATan2Rad 


Category: 

Math 

Description: 

Returns the angle portion of a complex number in rectangular form — forced 
to return the angle in radians no matter what the current system angle settings 
are. 


inputs: 

Registers: None 
Flags: None 

Others: OP1 = imaginary part of complex number, floating-point number 

OP2 = real part of complex number, floating-point number 

Outputs: 

Registers: None 
Flags: None 


Others: 

OP1 = the angle portion of the polar form of the input rectangular complex 
number. 

Registers 

destroyed: 

All 

RAM used: 

Remarks: 

Example: 

OP1 -OP5 
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System Routines — Math 


ATanH 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 
Remarks: 


Example: 


Math 

Computes the inverse hyperbolic tangent of a floating point. 

None 

None 

OP1 = floating point 

None 

None 

OP1 = inverse hyperbolic tangent (floating point) 

All 

OP1, OP2, OP3, OP4, OP5 
Initial input rules: 

If floating point = 0, then output = 0. 

If the absolute value of input is greater than 1 then domain 
error. 

FOR |OP1 1 <.7 Use Cordic; otherwise, use Logs. 
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System Routines — Math 


ATanRad 


Category: Math 

Description: Computes the inverse tangent of a floating point and forces radian mode. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = inverse tangent (floating point) 

Registers All 
destroyed: 


RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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System Routines — Math 


CAbs 

Category: Math 

Description: Computes the magnitude of a complex number. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex number 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

OP1 = floating point result, a real number 

All 

RAM used: 

OP1 -OP4 

Remarks: 

SqRoot(OP1 A 2 + OP2 A 2). 

Example: 

B_CALL CAbs 


TI-83 Plus Developer Guide 


10-15 


Third Release January 25, 2002 


System Routines — Math 


CAdd 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Addition of two complex numbers. 

None 

None 

OP1/OP2 = second argument 
FPS1/FPST = first argument 

None 

None 

OP1/OP2 = complex result (first argument) + (second Argument) 
All 

OP1 -OP2 

First argument is removed from the FPS (Floating Point Stack). 

See CSub. 
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System Routines — Math 


CDiv 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Division of two complex numbers. 

None 

None 

OP1/OP2 = second argument 
FPS1/FPST = first argument 

None 

None 

OP1/OP2 = complex result (first argument) / (second Argument) 
All 

OP1 -OP4 

First argument is removed from the FPS (Floating Point Stack). 

See CSub. 
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System Routines — Math 


CDivByReal 


Category: Math 

Description: Divides a complex number by a real number. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex number 

OP3 = floating point real number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex result, OP1/OP2 / OP3 

OP3 = intact 


Registers All 
destroyed: 


RAM used: OP1 -OP4 

Remarks: 

Example: B_CALL CDivByReal 
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System Routines — Math 


CEtoX 

Category: Math 

Description: Returns e A X where X is a complex number. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex number 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

OP1/OP2 = complex result 

All 

RAM used: 

Remarks: 

OP1 -OP6 

Example: 

B_CALL CEtoX 
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System Routines — Math 


CFrac 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Returns the fractional part of both the real and imaginary components of a 
complex number. 

None 

None 

OP1/OP2 = complex number 

None 

None 

OP1/OP2 = complex result 
All 

OP1, OP2 

B_CALL CFrac 
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System Routines — Math 


Clntgr 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 
Remarks: 


Example: 


Math 

Executes the Intgr function on a complex number. 

None 

None 

OP1/OP2 = complex number 

None 

None 

OP1/OP2 = complex result 
All 

OP1, OP2 

Return the next integer less than or equal to, for both the real and imaginary 
parts of the complex number. 

See Intgr. 

B_CALL Clntgr 
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System Routines — Math 


Cklnt 


Category: Math 

Description: Tests floating-point number to be an integer. 

Inputs: 

Registers: HL = pointer to the exponent of the number to check 
Flags: None 

Others: None 

Outputs: 

Registers: Z = 1 if integer, Z = 0 if noninteger 

Flags: None 

Others: None 

Registers All 

destroyed: 


RAM used: OP1 -OP5 

Remarks: If exponent of OP1 > 13 then it is considered to be an integer. 

Example: 
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System Routines — Math 


CkOdd 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 
Remarks: 

Example: 


Math 

Tests if a floating-point number is odd or even. 

HL = pointer to exponent of number to check 

None 

None 

None 

If even, then Z = 1 . If odd, then Z = 0. 

None 

All 

None 

If exponent of OP1 > 13, then it is considered to be an even. 

If 0 < Abs(OPI) < 1, then it is considered odd, negative exponent. 

Test a floating-point number in OP1 for add/even. 

LD HL,OPl+l 

B_CALL CkOdd 

JP Z, Is_Even 
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System Routines — Math 


CkOPICO 


Category: Math 

Description: Tests a complex number in OP1/OP2 to be (0,0). 

Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex number 

Outputs: 

Registers: None 

Flags: If (0,0), then Z = 1 ; otherwise, Z = 0. 

Others: None 

Registers A 

destroyed: 


Remarks: 

Example: b_call ckopico 
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System Routines — Math 


CkOPICpIx 

Category: Math 

Description: Tests value in OP1 for complex data type. 

Inputs: 

Registers: None 

Flags: None 

Others: (OP1) = objects data type byte 

Outputs: 

Registers: None 

Flags: If OP1 contains a complex number, then Z = 1 ; otherwise, Z = 0 


Others: 

None 

Registers 

destroyed: 

A 

RAM used: 

Remarks: 

None 

Example: 

B_CALL CkOPICpIx 
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System Routines — Math 


CkOPlFPO 

Category: Math 

Description: Tests floating-point number in OP1 to be 0 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point number 

Outputs: 

Registers: None 
Flags: Z = 1 : OP1 = 0 



Z = 0: OP1 <> 0 

Others: 

None 

Registers 

destroyed: 

A 

RAM used: 

Remarks: 

None 

Example: 

B_CALL CkOPlFPO 
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System Routines — Math 


CkOPIPos 

Category: Math 

Description: Tests floating-point number in OP1 to be positive. 

Inputs: 

Registers: None 
Flags: None 

Others: (OP1) = sign byte of floating-point number in OP1 

Outputs: 

Registers: ACC bit 7 = sign bit 

Flags: If OP1 > 0, Z = 1 ; otherwise, Z = 0. 


Others: 

None 

Registers 

destroyed: 

A 

RAM used: 

Remarks: 

None 

Example: 

B_CALL CkOPIPos 
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System Routines — Math 


CkOPIReal 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Tests object in OP1 to be a real data type. 

None 

None 

(OP1) = objects data type byte 
ACC = data type of object in OP1 

If OP1 contains a real number, then Z = 1 ; otherwise, Z = 0. 

None 

A 

None 

B_CALL CkOPIReal 
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System Routines — Math 


CkOP2FPO 

Category: Math 

Description: Tests floating-point number in OP2 to be 0 

Inputs: 

Registers: None 

Flags: None 

Others: OP2 = floating-point number 

Outputs: 

Registers: None 

Flags: If OP2 = 0, then Z = 1 ; otherwise, Z = 0. 


Others: 

None 

Registers 

destroyed: 

A 

RAM used: 

Remarks: 

None 

Example: 

B_CALL CkOP2FP0 
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System Routines — Math 


CkOP2Pos 

Category: Math 

Description: Tests floating-point number in OP2 to be positive. 

Inputs: 

Registers: None 

Flags: None 

Others: (OP2) = sign byte of floating-point number in OP2 

Outputs: 

Registers: ACC bit 7 = sign bit 

Flags: If OP2 > 0, then Z = 1 ; otherwise, Z = 0. 


Others: 

None 

Registers 

destroyed: 

A 

RAM used: 

Remarks: 

None 

Example: 

B_CALL CkOP2Pos 
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System Routines — Math 


CkOP2Real 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Tests object in OP2 to be a real data type. 

None 

None 

(OP1) = objects data type byte 
ACC = data type of object in OP2 

If OP2 contains a real number, then Z = 1 ; otherwise, Z = 0. 

None 

A 

None 

B_CALL CkOP2Real 
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System Routines — Math 


CkPosInt 

Category: Math 

Description: Tests floating-point number in OP1 to be a positive integer. 

Inputs: 

Registers: OP1 = floating-point number 
Flags: None 

Others: None 

Outputs: 

Registers: If OP1 is a positive integer, then Z = 1 . 

Flags: None 


Others: 

None 

Registers 

destroyed: 

All 

RAM used: 

Remarks: 

None 

Example: 

B_CALL CkPosInt ; check OP1 = positive integer 

JR Z,PosInt ; jump if positive integer 
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System Routines — Math 


CkValidNum 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Math 

Checks for a valid number for a real or complex number in OP1/OP2. 
OP1 , if real 

OP1 and OP2, if complex 

None 

None 


Err: Overflow if exponent > 100 
Value set to 0 if exponent < -99 

None 

None 

AF, HL 


This should be used before storing a real or complex to a user variable or a 
system variable. 

Intermediate results from the math operations can generate values outside of 
the valid exponent range for the TI-83 Plus. This routine will catch those 
cases. 

If this is not done, then problems can occur when trying to display the invalid 
numbers. 


This does not need to be done after every floating-point operation. The core 
math routines can handle exponents in the range or +/- 127. 

After a floating-point multiply, check the result for validity before stringing to 
variable X. Assume OP1 and OP2 have values already. 


B_CALL 

B_CALL 

B_CALL 


FPMult 

CkValidNum 

StoX 


; generate value to store to 'X' 
; make sure valid exponent 
; store to 'X' 
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System Routines — Math 


CLN 


Category: Math 

Description: Computes the natural log of a complex number. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex result 

Registers All 
destroyed: 


RAM used: OP1 -OP6 

Remarks: 

Example: b_call cln 
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System Routines — Math 


CLog 

Category: Math 

Description: Computes the base 10 log of a complex number. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex result 

Registers All 
destroyed: 


RAM used: OP1 -OP6 

Remarks: 

Example: b_call CLog 
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System Routines — Math 


ClrLp 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


Math 

Clears a memory block (to OOh’s). 

HL = address of start of memory block 
B = number of bytes to clear 

None 

None 

None 

None 

Memory block cleared 
B, HL 


Remarks: None 

Example: 
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System Routines — Math 


ClrOPIS 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Math 

Clears the mantissa sign bit in OP1 . 

None 

None 

None 

None 

None 

None 


This routine only acts on the display, not the textShadow. 
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System Routines — Math 


CMItByReal 


Category: Math 

Description: Multiplies a complex number by a real number. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex number 

OP3 = floating point real number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex result, OP1/OP2 OP3 

OP3 = intact 


Registers All 
destroyed: 


RAM used: OP1 -OP4 

Remarks: 

Example: b_call avutByReai 
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System Routines — Math 


CMult 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Multiplication of two complex numbers. 

None 

None 

OP1/OP2 = second argument 
FPS1/FPST = first argument 

None 

None 

OP1/OP2 = complex result (first argument) * (second argument) 
All 

OP1 -OP4 

First argument is removed from the FPS (Floating Point Stack). 

See CSub. 


TI-83 Plus Developer Guide 


10-39 


Third Release January 25, 2002 


System Routines — Math 


Conj 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Math 

Computes the complex conjugate of a real complex number. 

None 

None 

OP1/OP2 = real complex number 

None 

None 

OP2 = -OP2, negate imaginary 
Set OP1/OP2 = current complex mode 


Registers All 
destroyed: 


Remarks: No error checking. Sets Ans to the current complex mode. 

Example: 
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System Routines — Math 


COP1 Seto 


Category: 
Description: 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 


Math 

Puts a complex (0,0) in OP1/OP2. 


Flags: 

Others: 

Registers 

destroyed: 


None 

OP1/OP2 = complex (0,0) 
A, HL 


Remarks: OP1 is not modified. 

Example: 
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System Routines — Math 


Cos 


Category: Math 

Description: Computes the cosine of a floating point. 

Inputs: 

Registers: None 

Flags: None 

Others: Current angle mode 

OP1 = floating point 


Outputs: 

Registers: None 
Flags: None 

Others: OP1 = cosine (floating point) 

Registers All 

destroyed: 


RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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System Routines — Math 


CosH 


Category: Math 

Description: Computes the hyperbolic cosine of a floating point. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = hyperbolic cosine (floating point) 

Registers All 
destroyed: 


RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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System Routines — Math 


Cp0P10P2 


Category: Math 

Description: Compares floating-point values in OP1 and OP2. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point value 

OP2 = floating-point value 

Outputs: 

Registers: None 

Flags: Z=1:OP1=OP2 

Z = 0, CA = 1:OP1 < OP2 
Z = 0, CA = 0: OP1 >= OP2 


Others: None 

Registers A, BC, DE, HL 

destroyed: 


Remarks: OP1 and OP2 are preserved. 

Example: 
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System Routines — Math 


Cp0P40P3 


Category: Math 

Description: Compares floating-point values in OP4 and OP3. 

Inputs: 

Registers: None 
Flags: None 

Others: OP4 = floating-point value 

OP3 = floating-point value 

Outputs: 

Registers: None 

Flags: Z=1:OP4 = OP3 

Z = 0, CA = 1 : OP4 < OP3 
Z = 0, CA = 0: OP4 >= OP3 


Others: None 

Registers A, BC, DE, HL 

destroyed: 


RAM used: OP1 , OP2 

Remarks: OP4 and OP3 are preserved. 

Example: 
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CRecip 

Category: Math 

Description: Computes the reciprocal of a complex number. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = input complex number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = resulting complex number 

Registers All 
destroyed: 


RAM used: OP1 -OP4 

Remarks: 

Example: b_call CRecip 
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System Routines — Math 


CSqRoot 


Category: Math 

Description: Computes the square root of a complex number. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex result 

Registers All 
destroyed: 


RAM used: OP1 -OP6 

Remarks: 

Example: b_call csqRoot 
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System Routines — Math 


CSquare 

Category: Math 

Description: Computes the square of a complex number. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex result 

Registers All 
destroyed: 


RAM used: OP1 -OP4 

Remarks: 

Example: B_CALL CSquare 
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System Routines — Math 


CSub 


Category: Math 

Description: Subtracts two complex numbers. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = second argument 

FPS1/FPST = first argument 

Outputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex result (first argument) - (second argument) 

Registers All 
destroyed: 


RAM used: 

Remarks: 

Example: 


OP1 -OP3 


First argument is removed from the FPS (Floating Point Stack). 
Assume that variable X and Y both have complex values. 

Recall the contents and subtract Y from X, such that OP1/OP2 = X - Y 


B_CALL RclX ; OP1/OP2 = complex value of X 


; This next call pushes OP1 the real part of the complex #, onto FPST; 
; then pushes OP2, the imaginary part, onto the FPST which pushes the 
; real part to FPS1 position. 


; FPS1 = 1st argument real part 
; FPST = 1st argument imaginary part 

r 

B_CALL PushMCplxOl 

r 

B_CALL RclY 

r 

B_CALL CSub 


; push 1st argument on FPS, X 

; OP1/OP2 = complex value of Y 

; OP1/OP2 = result X N Y, FPS 
; is cleaned 
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CTenX 

Category: Math 

Description: Returns 10 A X where X is a complex number. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex number 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

OP1/OP2 = complex result 

All 

RAM used: 

Remarks: 

OP1 -OP6 

Example: 

B_CALL CTenX 
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System Routines — Math 


CTrunc 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Returns the integer part of both the real and imaginary components of a 
complex number; no rounding is done. 

None 

None 

OP1/OP2 = complex number 

None 

None 

OP1/OP2 = complex result 
All 

OP1, OP2 

No rounding is done; for example, Trunc (1 .5 + 3i) returns 1 + 3i. 

B_CALL CTrunc 
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System Routines — Math 


Cube 

Category: Math 

Description: Computes the cube of a floating-point number. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point number 

Outputs: 

Registers: None 
Flags: None 


Others: 

OP1 = OP1 A 3 

Registers 

destroyed: 

A, BC, DE, HL 

RAM used: 

Remarks: 

OP1 -OP3 

Example: 

B_CALL Cube 
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System Routines — Math 


CXrootY 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Returns the complex root of a complex number, y A (1/x). 

None 

None 

OP1/OP2 = second argument (y) 

FPS1/FPST = first argument (x) 

None 

None 

OP1/OP2 = complex result second_argument A (1/(first_argument)) 
All 

OP1 -OP6 

First argument is removed from the FPS (Floating Point Stack). 

See CSub. 
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CYtoX 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Raises a complex number to a complex power, y A x. 

None 

None 

OP1/OP2 = second argument (x) 

FPS1/FPST = first argument (y) 

None 

None 

OP1/OP2 = complex result first_argument A (second_argument) 
All 

OP1 -OP6 

First argument is removed from the FPS (Floating Point Stack). 

See CSub. 
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DecOI Exp 


Category: 
Description: 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 

Outputs: 

Registers: None 


Math 

Decrements OP1 exponent. 


Flags: 

Others: 

Registers 

destroyed: 


None 

Decrement OP1 exponent by one. 
A 


Remarks: 

Example: b_call DecoiExp 
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DToR 


Category: Math 

Description: Converts the floating-point number in OP1 from a degrees angle to a radian 

angle. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


None 

None 

OP1 = floating-point number to convert 

None 

None 

OP1 = floating-point number representing the radian angle of the input value 
All 

OP1, OP2, OP3 
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EToX 

Category: Math 

Description: Computes e A OP1 = 10 A (OP1*LOG(e)). 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = value e is raised to 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = result 

Registers All, OP2, OP3, OP4 
destroyed: 

Remarks: 

Example: 
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ExpToHex 


Category: Math 

Description: Converts absolute value of one-byte. 

Exponent (in HL) to hexadecimal. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


(HL) = exponent to convert 

None 

None 

(HL) = absolute value of exponent 

None 

None 

A 


Remarks: This converts the floating point exponent value from the offset type 

(e.g., 7Fh = 10 A -1 , 80h = 10 A 0, 81 h = 10 A 1 ,...) to a value of 0...n. It treats 
positive and negative exponents the same: 

e.g., 80h = 0 
81 h = 1 
82h = 2 
7Fh = A1 
7Eh = A2 

See OPIExpToDec for another exponent conversion routine. 

Example: LD HL, Exponent 

LD (HL) , 7Eh 

B_CALL ExpToHex ; change (HL) from FEh N> 02h. 
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Factorial 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 


Math 

Computes the factorial of an integer or a multiple of .5. 

None 

None 

OP1 = floating-point number, must be an integer or a multiple of .5 in the 
range of -.5 to 69 


Outputs: 

Registers: None 
Flags: None 

Others: OP1 = factorial of input, floating-point number. Else, error if input is out of 

range. 


Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


All 

OP1 - OP3 
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FPAdd 


Category: Math 

Description: Floating point addition of OP1 and OP2. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number, argument one 

OP2 = floating-point number, argument two 


Outputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point result OP1 + OP2 

Registers All 

destroyed: 


RAM used: OP1 , OP2 

Remarks: 

Example: b_call FPAdd 
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FPDiv 


Category: Math 

Description: Floating point division of OP1 and OP2. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number, argument one 

OP2 = floating-point number, argument two 


Outputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point result OP1 / OP2 

OP2 = intact 


Registers All 
destroyed: 


RAM used: 0P1.0P2, OP3 

Remarks: 

Example: b_call fpdiv 
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FPMult 


Category: Math 

Description: Floating point multiplication of OP1 and OP2. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point number, argument one 

OP2 = floating-point number, argument two 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point result OP1 * OP2 

OP2 = intact 


Registers All 
destroyed: 


RAM used: 0P1.0P2, OP3 

Remarks: 

Example: b_call FPMuit 
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FPRecip 

Category: Math 

Description: Floating point reciprocal of OP1 . 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point result 1 / OP1 

OP2 = input OP1 

Registers All 
destroyed: 


RAM used: 0P1.0P2, OP3 

Remarks: 

Example: b_call FPRecip 
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FPSquare 


Category: Math 

Description: Floating point square of OP1 . 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point result OP1 OP1 

OP2 = input OP1 

Registers All 
destroyed: 


RAM used: 0P1.0P2, OP3 

Remarks: 

Example: B_CALL FPSquare 
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FPSub 


Category: Math 

Description: Floating point subtraction of OP1 and OP2. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number, argument one 

OP2 = floating-point number, argument two 


Outputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point result OP1 N OP2 

Registers All 

destroyed: 


RAM used: OP1 , OP2 

Remarks: 

Example: b_call FPSub 
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Frac 

Category: Math 

Description: Returns the fractional part of a floating-point number. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point number 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

OP1 = floating-point result 

All 

RAM used: 

OP1 

Remarks: 

No rounding; for example, Frac (1 .5) = .5 

Example: 

B_CALL Frac 


TI-83 Plus Developer Guide 


10-66 


Third Release January 25, 2002 


System Routines — Math 


HLTimes9 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Math 

Multiplies HL by nine. 

HL = multiplicand 

None 

None 

HL = HL * 9 modulo 65536 

CA = 1 : answer larger than 65535 
CA = 0: answer less than 65535 

None 

BC 

None 
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HTimesL 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Math 

Multiplies H (register) * L (register). 

H, L 

None 

None 

HL = product of (original H) * (original L) 

None 
None 
B, DE 

Restriction: H cannot be 0; If H is 0, performs 256 * 
Cannot overflow if H > 0. 
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Int 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Rounds a floating-point number to an integer. 

None 

None 

OP1 = floating-point number to round 

None 

None 

OP1 = Int (OP1) 

All 

OP1 

The mantissa sign of the input has no affect on the result. 

B_CALL Int 
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Intgr 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Math 

Returns the integer. 

None 

None 

OP1 = floating-point number 

None 

None 

OP1 = floating-point result 
A, BC, DE, HL 

If OP1 is an integer, then result = OP1. Otherwise, 
for positive numbers, returns the same as Trunc (OP1); 
for negative numbers, returns the Trunc (OP1 - 1). 
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InvOPIS 


Category: Math 

Description: Negates a floating-point number OP1 , if OP1 = 0 then set OP1 = positive. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point number. No check is made for a valid floating-point 

number. 


Outputs: 

Registers: None 
Flags: None 

Others: OP1 = A(OP1), unless 0 then it is set to positive. 

Registers A 

destroyed: 


Remarks: 

Example: Set OP1 = A1 

B_CALL OPISetl ; OP1 = floating point 1 

B_CALL InvOPIS ; OP1 = -1 
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InvOPISC 


Category: Math 

Description: Used to negate a complex number in OP1/OP2 by negating both OP1 and 

OP2. If OP1 or OP2 = 0, then that OP register is set positive. 


Inputs: 

Registers: None 
Flags: None 


Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


OP1/OP2 = two floating-point numbers that make up a complex number 


None 

None 

OP1 = 
OP2 = 


-(OP1), unless 0 then it is set to positive 
-(OP2), unless 0 then it is set to positive 


Remarks: 


Example: 
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lnvOP2S 


Category: Math 

Description: Negates a floating-point number OP2, if OP2 = 0 then set OP2 = positive. 

Inputs: 

Registers: None 
Flags: None 

Others: OP2 = floating-point number, no check is made for a valid floating-point 

number. 


Outputs: 

Registers: None 


Flags: 

Others: 

Registers 

destroyed: 


None 
OP2 = 
A 


-(OP2), unless 0 then it is set to positive 


Remarks: 

Example: Set OP2 = -1 

; OP2 = floating point 1 
; OP 2 = -1 


B_CALL OP 2 Set 1 

B_CALL InvOP2S 
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InvSub 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Negates OP1 and add to OP2. 

None 

None 

OP1 = floating point 
OP2 = floating point 

None 

None 

OP1 = floating point with value (-OP1 ) + OP2 
A, BC, DE, HL 

OP1, OP2 
None 
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LnX 


Category: Math 

Description: Returns natural log of a floating-point number in OP1 . 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point number, must be positive 

Outputs: 

Registers: None 


Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


None 

Error if OP1 is negative 
Else OP1 = Ln(OPI) 

All 


OP1 -OP5 

A system error can be generated. See section on Error Handlers. 

Compute the Ln(OPI), install an error handler to avoid the system reporting 
the error. 


AppOnErr CatchError 


install error handler 


B_CALL LnX 


; compute Ln(OPl) 


AppOf f Err 


; remove error handler, no 
; error occurred 


RET 


; come here if LnX generated an error 

r 

CatchError : 


TI-83 Plus Developer Guide 


10-75 


Third Release January 25, 2002 


System Routines — Math 


LogX 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Returns log base 1 0 of a floating-point number in OP1 . 

None 

None 

OP1 = floating-point number, must be positive 

None 

None 

Error if OP1 is negative 
Else OP1 = Log(OPI) 

All 

OP1 - OP5 

A system error can be generated. See section on Error Handlers. 
See LnX. 
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Max 

Category: Math 

Description: Returns the maximum (OP1 , OP2), two floating-point numbers 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point number 

OP2 = floating-point number 

Outputs: 

Registers: None 
Flags: None 


Others: 

OP1 = maximum (OP1, OP2) 

OP2 = intact 

Registers 

destroyed: 

All 

RAM used: 

OP1 -OP4 

Remarks: 

Example: 

See Cp0P10P2, for non destructive compare. 
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Min 


Category: Math 

Description: Computes the minimum of two floating-point numbers. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number argument one 

OP2 = floating-point number argument two 


Outputs: 

Registers: None 


Flags: None 

Others: OP1 = minimum (OP1, OP2) 

OP2 = intact 
OP3 = argument one 
OP4 = argument two 

Registers A, BC, DE, HL 

destroyed: 


RAM used: OP1 -OP4 

Remarks: 

Example: 
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Minusl 


Category: Math 

Description: Floating point subtraction of one from OP1 . 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point result OP1 - 1 

Registers All 
destroyed: 


RAM used: OP1 , OP2 

Remarks: 

Example: b_call Minusi 
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OPIExpToDec 


Category: Math 

Description: Converts absolute value of exponent to a bed number. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 + 1 = exponent to convert 

Outputs: 

Registers: (HL) = OP1 + 1 = |Exp| as hex 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


A = |Exp| as bed 
None 

OP1 + 1 = |Exp| as hex 
A, BC 

Overflow Error if |Exp| > 99 


; Input 

OP1 + 

1 value 

-> Output 

OP1 

+ 

8 lh 

(10' 

'1 ) 

-> 

Olh 

& 

Olh 

7Fh 

(10' 

'-1 ) 

-> 

Olh 

& 

Olh 

8Dh 

(10' 

'13 ) 

-> 

ODh 

& 

13h 

7 3h 

(10' 

'-13) 

-> 

ODh 

& 

13h 


1 and A register 
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OPISetO, OPISetl, OP1Set2, OP1Set3, OP1Set4, 
OP2SetO, OP2Set1 , OP2Set2, OP2Set3, OP2Set4, 
OP2Set5, OP2Set60, OP3SetO, OP3Set1 , OP3Set2, 
OP4SetO, OP4Set1 , OP5SetO 

Category: Math Utility 

Description: Sets value of OP(x) to floating point (value). 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 

Others: OP(x) = floating-point value 

Registers A, HL 
destroyed: 


Remarks: 

Combinations Available: 







Value 

0 

1 

2 

3 

4 

5 

60 


Register 

OP1 

X 

X 

X 

X 

X 




OP2 

X 

X 

X 

X 

X 

X 

X 


OP3 

X 

X 

X 






OP4 

X 

X 







OP5 

X 







Example: 

B_CALL 

OP2Set5 
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OP2Set8 


Category: 
Description: 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 


Math 

Sets OP2 = floating point 8. 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


None 

OP2 = floating point 8 
A, HL 
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OP2SetA 


Category: Math 

Description: Sets OP2 = floating-point value between 0 and 9.9. 

Inputs: 

Registers: ACC = two digits of mantissa to set OP2 to 

Flags: None 

Others: OP2 set to floating-point value 

Outputs: 

Registers: None 


Flags: 


None 


Others: None 

A, HL 


Registers 

destroyed: 


Remarks: 

Example: 


Set OP 2 =7.6 

LD A, 7 6h 

B_CALL OP 2 Set A 


; mantissa digits 
; OP 2 =7.6 
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Plusl 


Category: Math 

Description: Floating point addition of one to OP1 . 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point result OP1 + 1 

Registers All 
destroyed: 


RAM used: OP1 , OP2 

Remarks: 

Example: b_call piusi 
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PToR 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Converts complex number in OP1/OP2 from a polar complex number to a 
rectangular complex number. 

None 

None 

OP1 = floating-point number radius part of complex number 
OP2 = floating-point number angle part of complex number 

None 

None 

OP1/OP2 = rectangular representation of input polar complex number 
All 

OP1 - OP6 
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Randlnit 


Category: 

Math 

Description: 

Inputs: 

Initializes random number seeds to default value. 

Registers: 

None 

Flags: 

None 

Others: 

None 

Outputs: 

Registers: 

None 

Flags: 

None 

Others: 

None 

Registers 

destroyed: 

HL, DE, BC 

Remarks: 

Example: 

Seeds initialized. 
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Random 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Returns a random floating-point number, 0 < number < 1 . 

None 

None 

None 

None 

None 

OP1 = floating point random number 
All 

OP1 -OP3 

See RnFx and Round routines. 
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RName 


Category: Math 

Description: Constructs a name for real variable R in the format required by routine 

FindSym. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


None 

None 

None 

None 

None 

OP1 = contains variable name for R in format required by routine FindSym 
A, HL 


Remarks: This routine is used to prepare for a call to routine FindSym. 

Example: 
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RndGuard 

Category: Math 

Description: Rounds a floating-point number to 10 mantissa digits. The exponent value has 

no effect on this routine. 

Inputs: 

Registers: None 
Flags: None 


Others: 

OP1 = floating-point number to round to 10 mantissa digits 

(fmtDigits) = current fix value 

Offh = floating, no rounding will be done 

Otherwise, the value is the number of decimal 

Digits to round to, 0 - 9 


Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

OP1 = input floating point rounded to 10 mantissas digits 

All 

RAM used: 

OP1 

Remarks: 

Example: 

See the RnFx and Round routines. 
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RnFx 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Rounds a floating-point number to the current FIX setting for the calculator. 
This will round the digits following the decimal point. 


None 

None 

OP1 = floating-point number to round 


None 

None 

OP1 = input rounded to at maximum of 10 mantissa digits 

(fmtDigits) = current fix value 
Offh = floating, no rounding will be done 
Otherwise, the value is the number of decimal 
Digits to round to, 0 - 9 

All 

OP1 

See Round and RndGuard routines. 
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Round 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 


Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Rounds a floating-point number to a specified number of decimal places. This 
will round the digits following the decimal point. 

D = number of decimal places to round to, 0 - 9 
None 

OP1 = floating-point number to round 

(fmtDigits) = current fix value 

Offh = floating, no rounding will be done 

Otherwise, the value is the number of decimal digits to round to, 0 - 9 

None 

None 

OP1 = input rounded to at maximum of 10 mantissa digits 
All 

OP1 

See RnFx and RndGuard routines. 
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RToD 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Converts the floating-point number in OP1 from a radian angle to a degree 
angle. 

None 

None 

OP1 = floating-point number to convert 

None 

None 

OP1 = floating-point number representing the degree angle of the input value. 
All 

OP1, OP2, OP3 
See DToR routine. 
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RToP 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Converts complex number in OP1/OP2 from a rectangular complex number to 
a polar complex number. 


None 

None 

OP1 = floating-point number X part of complex number 
OP2 = floating-point number Y part of complex number 

None 

None 

OP1/OP2 = polar representation of input rectangular complex number 
All 

OP1 - OP6 
See RToP routine. 
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Sin 


Category: Math 

Description: Computes the sine and cosine of a floating point. 

Inputs: 

Registers: Current angle mode 
OP1 = floating point 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = sine (floating point) 

OP2 = cosine (floating point) 


Registers All 
destroyed: 


RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: b_call sin 
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SinCosRad 

Category: Math 

Description: Computes the sine and cosine of a floating point and radian mode is forced 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

OP1 = sine (floating point) 

OP2 = cosine (floating point) 

All 

RAM used: 

Remarks: 

OP1, OP2, OP3, OP4, OP5 

Example: 

B_CALL SinCosRad 
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SinH 


Category: Math 

Description: Computes hyperbolic sine of a floating point. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = hyperbolic sine (floating point) 

Registers All 
destroyed: 


RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: b_call sine 
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SinHCosH 

Category: Math 

Description: Computes the hyperbolic sine and cosine of a floating point. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

OP1 = hyperbolic sine (floating point) 

OP2 = hyperbolic cosine (floating point) 

All 

RAM used: 

Remarks: 

OP1, OP2, OP3, OP4, OP5 

Example: 

B_CALL SinHCosH 
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SqRoot 

Category: Math 

Description: Returns the square root of OP1 . 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point number, must be positive 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Error if OP1 is negative, else OP1 = Sqrt(OPI) 

All 

RAM used: 

OP1 -OP3 

Remarks: 

Example: 

See section on Error Handlers. 
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Tan 


Category: Math 

Description: Computes the tangent of a floating point. 

Inputs: 

Registers: None 

Flags: None 

Others: Current angle mode 

OP1 = floating point 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = tangent (floating point) 

Registers All 
destroyed: 


RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: b_call Tan 
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TanH 


Category: Math 

Description: Computes the hyperbolic tangent of a floating point. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = hyperbolic tangent (floating point) 

Registers All 
destroyed: 


RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: b_call TanH 
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TenX 

Category: Math 

Description: Returns 10 A (OP1). 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point number 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

OP1 = 10 A (OP1) 

All 

RAM used: 

Remarks: 

Example: 

OP1 -OP4 
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ThetaName 


Category: Math 

Description: Constructs a name for real variable Theta in the format required by routine 

FindSym. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


None 

None 

None 

None 

None 

OP1 = contains variable name for Theta in format required by routine 

FindSym 

A, HL 


Remarks: This routine is used to prepare for a call to routine FindSym. 

Example: 
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Times2 


Category: Math 

Description: Calculates OP1 times two. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point with value OP1 * 2.0 

OP2 = floating point 2 

Registers A, BC, DE, HL 
destroyed: 


RAM used: OP1 , OP2 

Remarks: None 

Example: 
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TimesPt5 


Category: Math 

Description: Calculates OP1 times 0.5. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point with value OP1 * 0.5 

OP2 = floating point 0.5 

Registers A, BC, DE, HL 
destroyed: 


RAM used: OP1 , OP2 

Remarks: 

Example: 
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TName 


Category: Math 

Description: Constructs a name for real variable T in the format required by routine 

FindSym. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


None 

None 

None 

None 

None 

OP1 = contains variable name for T in format required by routine FindSym 
A, HL 


Remarks: This routine is used to prepare for a call to routine FindSym. 

Example: 
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ToFrac 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

Remarks: 

Example: 


Math 

Converts a floating-point number to the integer numerator and integer 
denominator of the equivalent fraction. 

None 

None 

OP1 = floating-point number 


None 

Carry = 0: Success 
= 1 : Failure. 


OP1 : 

On Failure — unchanged. 

On Success — Numerator (floating-point integer) 

OP2: 

On Failure — unchanged. 

On Success — Denominator (floating-point integer) 

All 

Also modifies OP3, OP4, OP5, OP6. 

Smallest possible denominator is created. 

Fails if denominator must be > 999. 

LD HL, ExampleNum 

RST rMov9ToOPl 

; OP1 =1.25 

B_CALL ToFrac 

; Convert to fraction form 

; Carry is now 0 (success) 

; OP1 now contains: OOh 80h 50h OOh OOh OOh OOh OOh OOh = 5 

; OP2 now contains: OOh 80h 40h OOh OOh OOh OOh OOh OOh = 4 
LD HL, ExampleNum2 

RST rMov9ToOPl 

; OP1 = 1.2345678901234 

B_CALL ToFrac 

; Convert to fraction form 
; Carry is now 1 (failure) 

; ExampleNum = 1.25 


ExampleNum: DB 

OOh, 80h, 

12h, 

50h, 

OOh, 

OOh, 

OOh, 

OOh, 

OOh 

; ExampleNum2 = 

1 .2345678901234 







ExampleNum: DB 

OOh, 80h, 

12h, 

34h, 

5 6h, 

7 8h, 

90h, 

12h, 

34h 
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Trunc 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Math 

Truncates the fractional portion of a floating-point number returning the integer 
portion with no rounding. 

None 

None 

OP1 = floating-point number 

None 

None 

OP1 = Trunc (OP1) 

All 

OP1 - OP2 


Trunc (1.5) = 1 
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XName 


Category: Math 

Description: Constructs a name for real variable X in the format required by routine 

FindSym. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


None 

None 

None 

None 

None 

OP1 = contains variable name for X in format required by routine FindSym 
A, HL 


Remarks: This routine is used to prepare for a call to routine FindSym. 

Example: 
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XRootY 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 


Math 

Inverses power function and returns OP1 A (1/OP2). 

None 

None 

OP1 = number to find root of, floating point 
OP2 = root to find, floating point 


Outputs: 

Registers: None 
Flags: None 

Others: OP1 = result if no error, floating point 

Registers All 

destroyed: 


RAM used: OP1 -OP6 

Remarks: 

Example: 
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YName 


Category: Math 

Description: Constructs a name for real variable Y in the format required by routine 

FindSym. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


None 

None 

None 

None 

None 

OP1 = contains variable name for Y in format required by routine FindSym 
A, HL 


Remarks: This routine is used to prepare for a call to routine FindSym. 

Example: 
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YToX 


Category: Math 

Description: Power function, returns OP1 A OP2. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = number to raise to a power, floating point 

OP2 = power, floating point 


Outputs: 

Registers: None 
Flags: None 

Others: OP1 = result if no error, floating point 

Registers All 

destroyed: 


RAM used: OP1 -OP6 

Remarks: 

Example: 
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Zero'! 6D 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


Math 

Sets eight-byte memory block to all OOh’s. 

HL = start of target block in memory 

None 

None 

None 

None 

Memory block starting at original HL is all OOh’s 
A, HL 


Remarks: 

Example: 


TI-83 Plus Developer Guide 


10-112 


Third Release January 25, 2002 


System Routines — Math 


ZeroOP 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Math 

Sets 1 1 bytes in OP(x) to OOh. 

Note that this does not set the value to floating point 0.0. 

HL = pointer to OP(x), x = 1 ...6 

None 

None 

None 

None 

OP(x) = all 1 1 bytes OOh 
A (= 0), HL 


Set OP2 contents to all OOh: 


OP 2+0 OP2+1 OP2+3 OP2+4 OP2+5 OP2+6 OP2+7 


OOh 


OOh 


OOh 

LD 

B_CALL 


OOh 


OOh OOh 
HL, OP2 
ZeroOP 


OOh 


OP2+8 OP2+9 OP2+10 
OOh OOh OOh 
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ZeroOPI, ZeroOP2, ZeroOP3 

Category: Math 

Description: Sets 1 1 bytes in OP(x) to OOh. 

Note that this does not set the value to floating point 0.0. 

Inputs: 

Registers: None 


Flags: 

None 

Others: 

None 

Outputs: 


Registers: 

None 

Flags: 

None 

Others: 

OP(x) = all 1 1 bytes OOh 

Registers 

destroyed: 

A(= 0), HL 

Remarks: 

Combinations Available: 

(x) = 1 , 2, 3 

Example: 

; Set OP2 contents to all OOh: 

; OP 2+0 OP2+1 OP2+3 OP2+4 OP2+5 OP2+6 OP2+7 OP2+8 OP2+9 OP2+10 
; OOh OOh OOh OOh OOh OOh OOh OOh OOh OOh 

B_CALL ZeroOP2 
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11 

System Routines — 
Matrix 

AdrMEIe 

AdrMRow 

GetMToOPI 

PutToMat 

EH 

pTT2 

|n -3 

11-4 
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AdrMEIe 


Category: 

Description: 

Inputs: 

Registers: 


Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Other: 

Registers 

destroyed: 

Remarks: 


Example: 


List 

Computes the RAM address of an element of a matrix. 


DE = pointer to start of matrix’s data storage, output of FindSym 
BC = element’s (row, column) to compute address of Matrix Element (1 ,1) is 
checked for real or complex data type to determine if the matrix is real or 
complex. 

None 

None 


HL = pointer in RAM to start of desired element 

None 

None 

All 


This routine does not check to see if the element’s address requested is within 
the current dimension of the matrix. 

Do not use this routine on a matrix that does not have element (1,1) initialized. 
Compute the address of element (5,6) of matrix [A], 


MatAName : 


LD 

HL, MatAName 

RST 

rMov9ToOPl 

B_CALL 

FindSym 

JP 

C, Undef ined_A 

LD 

A, B 

OR 

A 

JP 

NZ , Archived_A 

LD 

BC, 5*256t6 

B_CALL 

AdrMEIe 


RET 


OP1 = [A] name 
look it up 

jump out if [A] is not 
defined; 

if b<>0 then [A] is 
archived in Flash ROM 

jump if not in RAM; 

DE = pointer to start of 
matrix data storage; 
element's address 
desired 

RET HL = pointer to 
element (5,6) 


DB MatOb j , tVarMat , tMat A, 0 , 0 
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AdrMRow 


Category: 

Description: 

Input: 

Registers: 


Flags: 

Others: 

Output: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Matrix 

Computes the RAM address of the start of a row of a matrix. 

DE = pointer to start of matrix's data storage, output of FindSym 
B = row to compute address of 

Matrix Element (1,1) is checked for real or complex data type to determine if 
the matrix is real or complex. 

Do not use this routine on a matrix that does not have element (1,1) initialized. 

None 

None 

HL = pointer in RAM to start of desired element 

None 

None 

All 

This routine does not check to see if the row address requested is within the 
current dimension of the matrix. See AdrMEIe routine. 
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GetMToOPI 

Category: Matrix 

Description: Copies an element from a matrix to OP1 . 

Input: 

Registers: BC = element to get, row, col 

DE = pointer to start of matrix's data storage 

Flags: None 

Others: None 

Output: 

Registers: HL = pointer to next element in the same row, or the start of the next row of 
the matrix. 


Flags: 

None 

Other: 

Registers 

destroyed: 

Remarks: 

Example: 

OP1 = matrix element, floating-point number 

All 
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PutToMat 

Category: Matrix 

Description: Stores a floating-point number to an existing element of a matrix. 

Inputs: 

Registers: BC = (row, column) to store to 

There is no check to see if this element is valid for the matrix. 

DE = pointer to the start of the matrix’s data area, output of FindSym 

Flags: None 

Others: None 

OP1 = floating-point number 

Outputs: 

Registers: DE = pointer to next element in the matrix. This will be the next element in the 
same row or the start of the next row. 

Flags: None 

Others: OP1 = intact 

Registers All 

destroyed: 

Remarks: 

Example: Look up MatA and store 1 to element (5,7). 


LD 

HL, MatAname 


B_CALL 

Mov9ToOPl 

; OP1 = name 

r 

B_CALL 

FindSym 

; look up 

RET 

C 

; return if undefined 

r 


; DE = pointer to data area 
; matrix 

r 

PUSH 

DE 

; save pointer 

B_CALL 

OPISetl 

; OP1 = 1 

r 

POP 

DE 


LD 

BC, 5*257+7 

; element to store to (5,7) 

B_CALL 

PutToMat 

; store 1 to element (5,7) 

RET 



MatAname : 



DB 

MatOb j , tVarMat , tMat A, 0 
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System Routines — 
Memory 


Arc_Unarc 

ChkFindSym 

ChkFindSym (continued) 

CleanAII 

CloseProg 

CmpSyms 

CreateOEqu 

CreateAppVar 

CreateCList 

CreateCpIx 

CreateEqu 

CreatePair 

CreatePict 

CreateProg 

CreateProtProg 

CreateReal 

CreateRList 

CreateRMat 

CreateStrng 

DataSize 

DataSizeA 

DeallocFPS 

DeallocFPSI 

DelMem 

DelMem (continued) 

DelVar 

DelVarArc 


• H3] 

.. I12-21 

.. 12^3 

.. VIA 

■ ■ 12^5 
.. 12^6 
.. 12^7 
.. 12^8 

■ ■ 12^9 
TFTO 

12U 

12-12 

HM3 

12-14 

12T5 

12^6“ 

12-17 

12-18 

12^9 

12-20 

12-21 

12^22 

12-23 

12-24 

12-25 

12-26 

12-27 
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DelVarNoArc 

EditProg 

EnoughMem 

Exch9 

ExLp 

FindAlphaDn 

FindAlphaDn (continued) 

FindAlphaUp 

FindAlphaUp (continued) 

FindApp 

FindAppNumPages 

FindAppDn 

FindAppUp 

FindSym 

FindSym (continued) 

FixTempCnt 

FlashToRam 

InsertMem 

InsertMem (continued) .... 

LdHLInd 

LoadCIndPaged 

LoadDEIndPaged 

MemChk 

PagedGet 

RclGDB2 

RcIN 

RcIVarSym 

RclX 

RclY 

RedimMat 

SetupPagedPtr 

SrchVLstDn, SrchVLstUp 


12-28 

HT29 

f2^30 

12-31 

12^32 

12-33 

i~2434 

12435 

12436 

12437 

12438 

12439 
12-40 

TImT 

12^42 

12-43 

TT44 

W45 

12-46 

12-47 

12^48 

12^49 

12-50 

T245T 

12-52 

12433 

12^54 

12-55 

12456 

12-57 

12458 

12459 
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Arc Unarc 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Swaps a variable between RAM and archive. 

None 

None 

OP1 contains variable name 

None 

None 

Symbol table and data area (RAM and Flash) modified. 

All 

Destroys OP3 as well. 

Will unarchive a variable already archived and will archive a variable that is 
currently unarchived. 

Gives an Err: Variable for any name that is not archivable or unarchivable 
(e.g., Groups cannot be unarchived and X cannot be archived). 

Gives an Err: Undefined for any name that does not already exist. 

Does memory checking to make sure there is enough space (in RAM or in 
Archive) to store the variable. Generates a memory error if not. 

unarchive variable A (real 
or complex) if it is 
archived : 


Nz If Archived: 


B_CALL 

ZeroOPl 

; set OP1 to all Os 

LD 

(OP1+1) , tA 

; want to look for floating 
; point number named 'A' 

RST 

rFindSym 

; Data pointer -> DE 
; System pointer -> HL 
; C if none 

JR 

C, skip 

; does not exist, so skip 

CALL 

Nz If Archived 

; NZ if was in RAM already. 

JR 

Z, skip 

; not archived, so no need to 
; unarchive 

B_CALL 

Arc_Unarc 

; unarchive variable. 

LD 

A, B 

; B has page information, NZ 
; if archived. 

OR 

RET 

A 
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ChkFindSym 


Category: 

Description: 


Inputs: 

Registers: 


Flags: 

Others: 

Outputs: 

Registers: 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Memory 

Searches the symbol table structure for a variable. 

This particular search routine must be used if the variable to search for is 
either a Program, AppVar, or Group. It will also work for variables of other 
types as long as the data type in OP1 input is correct. 

This is used to determine if a variable is created and also to return pointers to 
both its symbol table entry and data storage area. 

This will also indicate whether or not the variable is located in RAM or has 
been archived in Flash ROM. 


(OP1) = one-byte, data type of variable to search for. 

This routine will fail if this data type is not correct. 
(OP1 + 1) to (OP1 + 8) = variable name 

None 

None 


CA flag = 1 if symbol was not found 
= 0 if symbol was found 

Also if found: 

ACC lower 5 bits = data type 

ACC upper 3 bits = system flags about variable, do “AND 1 Fh” to get type only 
B = 0 if variable is located in RAM else variable is archived 
B = ROM page located on 

If variable is archived then its data cannot be accessed directly, it must be 
unarchived first. 

HL = pointer to the start of the variables symbol table entry 
DE = pointer to the start of the variables data area if in RAM 

None 

OP1 = variable name 
All 


This will not find system variables that are preallocated in system RAM such 
as Xmin, Xmax etc. Use RcISysTok to retrieve their values. 

Note: ChkFindSym will not find Applications. 

(continued) 
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ChkFindSym ( continued ) 


Example: 


Look for AppVar MYAPPVAR in the symbol table. 

If it exists and is archived then unarchive it and relook it up. 


If it does not exist ; create it with a size of 100 ; bytes. 


Relook : 


VarCreated : 


VarName : 


LD 

HL, VarName 


B_CALL 

Mov9ToOPl 

; OP1 = variable name 

B_CALL 

ChkFindSym 

; look up 

JR 

NC, VarCreated 

; jump if it exists 

LD 

HL, 100 

; size to create at 

B_CALL 

CreateAppVar 

; create it, HL = pointer 

PUSH 

HL 

; sym entry, DE = pointer 
; data 

PUSH 

DE 

; save during move 

B_CALL 

OP4ToOPl 

; OP1 = name 

POP 

DE 

; restore 

POP 

HL 


JR 

Done 


LD 

A, B 

; check for archived 

OR 

A 

; in RAM ? 

JR 

Z , done 

; yes 

B_CALL 

Arc_Unarc 

; unarchive if enough RAM 

JR 

Relook 

; look up pointers again 

RET 


; RAM now done : 


DB AppVarOb j , ' MYAPPVAR ' , 0 
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CleanAII 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Memory 

Deletes all temporary variables from RAM. 

None 

None 

None 


None 

None 

Temporary variables are all deleted 
All 


This routine should only be used when there are no temporary variables that 
exist and are still being used. See the Temporary Variables section in 
Chapter 2 for further information. See the Parselnp and MemChk routines. 
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CloseProg 


Category: 

Description: 

Inputs: 

Memory 

This routine is used after EditProg to return unused RAM back to free RAM. 
The size bytes of the variable are updated by this routine. An application 
should not update them. 


Registers: Each of these are two-bytes: 

(iMathPtrl) = pointer to the start of the variables data storage area 



(iMathPtr2) = pointer to the byte following the variable data, this will be used 
to calculate the new size of the variable 


(iMathPtr3) = pointer to the byte AFTER the last byte of free RAM inserted 

(iMathPtr4) = size of RAM block moved to allow the RAM to be inserted 

DO NOT CHANGE THIS VALUE. 

Flags: 

None 

Others: 

Outputs: 

None 


Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

Example: 

The variable’s size is changed. Unused RAM returned to free RAM. Normal 
allocating and deallocating of RAM can resume. 

All 
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CmpSyms 


Category: 

Description: 

Inputs: 

Registers: 


Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Memory 

Compares Name @HL with Name @DE. 


HL = end of first name in RAM 
DE = end of second name in RAM 
B = length of name 

None 

None 


C = number of letters that match 
C = original B if all letters match 

Carry set if Sym2 (HL) > Syml (DE) 

None 

AF, BC, DE, HL 


The names must be the same size. The name lengths should have already 
been compared before calling this routine. 


; See 
; the 


if the name last 

name "ZEBRA" 

used for the Xlist 

variable in statistics is 

LD 

HL, StZebra 


RST 

rMov9ToOPl ; 

Move 9 bytes to OP1: 


r 

"ZEBRA" + junk 

LD 

DE, OPl+4 


LD 

HL, StatX+4 


LD 

B, 5 

compare 5 bytes 

B_CALL 

CmpSyms ; 

If C = 5 then OP1 = StatX 


r 

name 

LD 

A, C 


CP 

5 


JR 

Z , Match 


JR 

NoMatch 


StZebra : 

DB "ZEBRA" 
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CreateOEqu 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Creates an equation variable of size 0 in RAM. 

None 

None 

OP1 = name of equation to create 


HL = pointer to variable’s symbol table entry 
DE = pointer to variable’s data storage, size bytes 

None 

OP4 = variable’s name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization is done, assume random. See section on 
Creating Variables. 

Create an empty Y1 equation. 



LD 

HL, Ylname 



RST 

rMov9ToOPl 

; OP1 = name 


B_CALL 

CreateOEqu 

; if returns then variable created 

Ylname : 

DB 

EquOb j , tVarEqu, tYl , 0 , 0 
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CreateAppVar 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Creates an AppVar variable in RAM. 

HL = size of AppVar to create in bytes 
None 

OP1 = name of AppVar to create 


HL = pointer to variable’s symbol table entry 
DE = pointer to variable’s data storage, size bytes 

None 

OP4 = variable’s name 
OP1 and OP2 


Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization is done, assume random. Users can only delete 
and link AppVars. They are intended for Apps to use for state saving upon 
exiting. See section on Creating Variables. 

Create AppVar DOG, 50 bytes in size. 


DOGname : 


LD 

HL, DOGname 


RST 

rMov9ToOP 1 

; OP1 = name 

LD 

HL, 50 


B_CALL 

CreateAppVar 

; if returns then variable 
; created 

DB 

AppVarObj, 'DOG' 

,0 


TI-83 Plus Developer’s Guide 


12-8 


Third Release January 25, 2002 


System Routines — Memory 


CreateCList 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Creates a complex list variable in RAM. 

HL = number of elements in the list 
None 

OP1 = name of list to create 


HL = pointer to variable’s symbol table entry 
DE = pointer to variable’s data storage, size bytes 

None 

OP4 = variable’s name 
OP1 and OP2 


Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization of the elements is done, assume random. See 
section on Creating Variables. 

Create complex list LI with 50 elements. 


Llname : 


LD 

HL, Llname 


RST 

rMov9ToOPl 

; OP1 = name 

LD 

HL, 50 


B_CALL 

CreateCList 

; if returns then variable 


; created 


DB CListOb j , tVarLst , tLl , 0 , 0 


TI-83 Plus Developer Guide 


12-9 


Third Release January 25, 2002 


System Routines — Memory 


CreateCpIx 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Creates a complex variable in RAM. 

None 

None 

OP1 = name of complex to create 


HL = pointer to variable’s symbol table entry 
DE = pointer to variable’s data storage 

None 

OP4 = variable’s name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. This should not be used to create temp storage space, 

A-Z or THETA. No initialization is done, assume random. See section on 
Creating Variables. 

Create complex A. 



LD 

HL, Aname 



RST 

rMov9ToOP 1 

; OP1 = name 

r 

B_CALL 

CreateCpIx 

; if returns then variable 
; created 

Aname : 

DB 

CplxOb j , ' A' , 0, 0 
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CreateEqu 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Creates an equation variable in RAM. 

HL = size of equation to create in bytes 
None 

OP1 = name of equation to create 


HL = pointer to variable’s symbol table entry 
DE = pointer to variable’s data storage, size bytes 

None 

OP4 = variable’s name 
OP1 and OP2 


Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization is done, assume random. See section on 
Creating Variables. 

Create Y1 equation 50 bytes in size. 


Ylname : 


LD 

HL, Ylname 


RST 

rMov9ToOPl ; 

OP1 = name 

LD 

HL, 50 


B_CALL 

CreateEqu ; 

if returns then variable 

DB 

EquOb j , tVarEqu 

, t Y1 , 0, 0 
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CreatePair 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Creates a pair of parametric graph equations. 

There should never be a situation where only 1 of a pair of parametric 
equations is created without the other. This routine will check that there is 
enough memory to create both equations before creating any. 


HL = size to create the equation specified in OP1 , either xt or yt. The member 
of the pair not specified will be created empty. 

None 

OP1 = pair member name to create with the specified size 


HL = size of pair member specified 
None 

OP1 = pair member name specified 
OP4 = pair member name not specified 

OP1 and OP2 


Memory error if not enough free RAM to create the pair. 

If xt# is specified then yt# is created empty. If yt# is specified then xt# is 
created empty. 

No checks are made for duplicate or valid names. No initialization is done, 
assume random. See section on Creating Variables. 


Create parametric pair of equations xtl 

and ytl , ytl at size 50. 

LD 

HL, ytlname 


RST 

rMov9ToOPl 

; OP1 = name 

r 

LD 

HL, 50 


B_CALL 

CreatePair 

; if returns then variables 
; created 

; OP1 = ytl, OP4 = xtl, HL 

ytlname: DB 

EquOb j , tVarEqu, tylt , 0, 0 
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CreatePict 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed 

Remarks: 


Example: 


Memory 

Creates a picture variable in RAM. 


None 

None 

OP1 = name of picture to create 

HL = pointer to variable’s symbol table entry 
DE = pointer to variable’s data storage, size bytes 

None 

OP4 = variable’s name 
OP1 and OP2 


Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. The size of a Pic var is 756 bytes, it does not allocate space for 
the last row of pixels, that row is never used by the system graph routines. 

If you need to save a bitmap of the entire display to a variable then an AppVar 
should be used. The only drawback to using an AppVar is that the Pic could 
not be displayed by the user when the app is not executing. 

No initialization is done, assume random. See section on Creating Variables. 

Create Pic Picl. 



LD 

HL, Piclname 



RST 

rMov9ToOPl 

; OP1 = name 

r 

B_CALL 

CreatePict 

; if returns then variable 
; created 

Piclname : 

DB 

Piet Ob j , tVarPict , tPicl , 0 , 0 
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CreateProg 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Creates a program variable in RAM. 

HL = size of program to create in bytes 
None 

OP1 = name of program to create 


HL = pointer to variable’s symbol table entry 
DE = pointer to variable’s data storage, size bytes 

None 

OP4 = variable’s name 
OP1 and OP2 


Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization is done, assume random. See section on 
Creating Variables. 

Create Program DOG, 50 bytes in size. 


DOGname : 


LD 

HL, DOGname 


RST 

rMov9ToOPl 

; OP1 = name 

LD 

HL, 50 


B_CALL 

CreateProg 

; if returns then 
; variable created 

DB 

ProgOb j , ' DOG 1 , 0 
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CreateProtProg 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Creates a protected program variable in RAM. 

HL = size of program to create in bytes 
None 

OP1 = name of program to create 


HL = pointer to variable’s symbol table entry 
DE = pointer to variable’s data storage, size bytes 

None 

OP4 = variable’s name 
OP1 and OP2 


Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization is done, assume random. Users cannot delete or 
edit protected programs, they can be deleted from an application. See section 
on Creating Variables. 

Create protected Program DOG, 50 bytes in size. 


DOGname : 


LD 

HL, DOGname 


RST 

rMov9ToOPl ; 

OP1 = name 

LD 

HL, 50 


B_CALL 

CreateProtProg ; 

r 

if returns then variable 

created 

DB 

ProtProgOb j , 'DOG' 

,0 
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CreateReal 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Memory 

Creates a real variable in RAM. 

None 

None 

OP1 = name of real to create 


HL = pointer to variable’s symbol table entry 
DE = pointer to variable’s data storage 

None 

OP4 = variable’s name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. This should not be used to create temp storage space, only A-Z 
and theta. No initialization is done, assume random. See section on Creating 
Variables. 


Example: 


Create real A. 



LD 

HL, Aname 



RST 

rMov9ToOP 1 

; OP1 = name 

r 

B_CALL 

CreateReal 

; if returns then variable 
; created 

Aname : 

DB 

RealOb j , ' A' 

o 

o 
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CreateRList 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Creates a real list variable in RAM. 

HL = number of elements in the list 
None 

OP1 = name of list to create 


HL = pointer to variable’s symbol table entry 
DE = pointer to variable’s data storage, size bytes 

None 

OP4 = variable’s name 
OP1 and OP2 


Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization of the elements is done, assume random. See 
section on Creating Variables. 

Create real list CAT with 50 elements. 


CATname : 


LD 

HL, CATname 


RST 

rMov9ToOPl 

; OP1 = name 

LD 

HL, 50 


B_CALL 

CreateRList 

; if returns then variable 


; created 


DB ListOb j , tVarLst , ' CAT ' , 0 
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CreateRMat 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Creates a real matrix variable in RAM. 

HL = dimension of matrix, (row, col), 99 is maximum row or column 
None 

OP1 = name of matrix to create 

HL = pointer to variable’s symbol table entry 
DE = pointer to variable’s data storage, dimension 

None 

OP4 = variable’s name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization of the elements is done, assume random. See 
section on Creating Variables. 

Create matrix [A] with 5 rows and 8 columns. 


LD 

HL, MatAname 


RST 

rMov9ToOPl ; 

OP1 = name 

LD 

HL, 5*256+8 ; 

5x8 

B_CALL 

CreateRMat ; 

r 

if returns then variable 

created 

DB 

Mat Ob j , tVarMat , 

, tMatA, 0, 0 
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CreateStrng 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Creates a string variable in RAM. 

HL = number bytes in string 
None 

OP1 = name of string to create 


HL = pointer to variable’s symbol table entry 
DE = pointer to variable’s data storage, size bytes 

None 

OP4 = variable’s name 
OP1 and OP2 


Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization of the string contents is done, assume random. 
See section on Creating Variables. 

Create string Strl 100 bytes in length. 


Str lname : 


LD 

HL, Strlname 

RST 

rMov9ToOPl 

LD 

HL, 100 

B_CALL 

CreateStrng 


; OP1 = name 

; size of string 
; if returns then variable 
; created 


DB StrngOb j , tVarStrng, tStr 1 , 0 , 0 
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DataSize 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Memory 

Computes the size, in bytes, of the data portion of a variable in RAM. 
ACC = data type 

HL = pointer to first byte of data storage 

None 

None 

DE = size of data storage in bytes 
HL = intact 

None 

None 

A, BC 


This routine cannot be used on archived variables or applications. 

If the variable’s data area has size information, like a list has two-bytes for 
number of elements, then those bytes are included in the computation. 


; Find 

LIName 

the size in bytes 

of the data 

area for list LI. 


DB 

Li st Ob j , tVarLst , tLl , 0, 0 

r 

LD 

HL, Llname 



RST 

rMov9ToOPl 

; OP1 = LI 

t 

B_CALL 

FindSym 

; find in symbol table, 

; DE = pointer to data 


AND 

lFh 

; ACC = data type information, 

; real or complex list 


EX 

DE, HL 

; HL = pointer to data storage 


B_CALL 

DataSize 

; DE = size of data storage 
; If LI were a real list with 
; elements then the size 
; returned would be 47 bytes. 

r 

5 elements *9 for 

each = 45 


r 

r 

r 

2 size bytes 

= 2 

47 
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DataSizeA 


Category: Memory 

Description: Computes the size, in bytes, of the data portion of a variable that has two size 

bytes as part of its data storage. 

This routine applies to equations, lists, matrices, programs, AppVars. 

Inputs: 


Registers: ACC = data type 

BC = two byte size information: dimension, number of bytes, number of 
elements 


Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


None 

None 

DE = size of data storage in bytes 

None 

None 

All 


If the variable’s data area has size information, like a list has two bytes for 
number of elements, then those bytes are included in the computation. 


Find the size in bytes 

of a complex 

list with 

5 elements: 

LD 

A, CListOb j 

; ACC = 

data type information 



; cplx 

list 

LD 

BC, 5 

; number elements 

B_CALL 

DataSizeA 

; DE = 

size of data storage 

5 elements *18 for each = 90 



2 size bytes 

= 2 




92 
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DeallocFPS 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Memory 

Removes space in nine-byte chunks from the Floating Point Stack. 

HL = number of chunks to remove 

None 

None 

None 

None 

FPS (Floating Point Stack top) decreased by HL 9 
DE, HL 

No values are removed from the deallocated space. 
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DeallocFPSI 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Memory 

Removes space in bytes from the Floating Point Stack. 

DE = number of bytes to remove 

None 

None 

None 

None 

FPS (Floating Point Stack top) decreased by HL 
HL 

No values are removed from the deallocated space. 
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DelMem 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Memory 

Deletes RAM from an existing variable. This routine will only delete the RAM. If 
the variable deleting from has a size field, it is NOT UPDATED. Updating must 
be done by the application. 


HL = address of first byte to delete 
DE = number of bytes to delete 

None 

None 

DE = intact 

BC = amount deleted 

RAM deleted 

None 

None 

All 


See InsertMem routine. 


(continued) 
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DelMem (continued) 

Example: Delete 1 0 bytes at the beginning of an AppVar. 


Created : 


AppVar Name : 


LD 

HL, AppVarName 

RST 

rMov9ToOPl 

B_CALL 

ChkFindSym 

JR 

NC, Created 

B JUMP 

ErrUnde fined 

,er to size 

bytes of AppVar 

PUSH 

DE 

INC 

DE 

INC 

DE 

LD 

HL, 10 

EX 

DE, HL 

B_CALL 

DelMem 

POP 

HL 

PUSH 

HL 

B_CALL 

ldHLind 

XOR 

A 

LD 

BC, 10 

SBC 

HL, BC 

EX 

DE, HL 

POP 

HL 

LD 

(HL) , E 

INC 

HL 

LD 

(HL) , D 

DB 

AppVarOb j , 'AVAR 


,< 


0P1 = name of AppVar 
look up in symTable 
jump if it exists 

error if not there 


save pointer to start of 
size bytes of data 

move DE to 1st byte of 
AppVar Data 

number bytes to insert 

HL = pointer to start of 
delete, DE number bytes 
delete the memory 

HL = pointer to size bytes 
save 

HL = size of AppVar, 
number bytes 

clear CA 


deer by amount deleted 

pointer to size bytes 
location 


write new size. 


TI-83 Plus Developer Guide 


12-25 


Third Release January 25, 2002 


System Routines — Memory 


DelVar 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Deletes a variable stored in RAM. 

All of the inputs for this routine are the outputs of FindSym and ChkFindSym. 
It is common to call one of these routines and then call DelVar immediately 
after. 

HL = pointer to start of symbol table entry of variable 
DE = pointer to start of data storage of variable 

B = 0 if variable resides in RAM else it is the page in the archive it is stored 

None 

None 


None 

None 

None 

All 


OP1 - OP6 are preserved. 

Variable’s symbol entry and data are deleted. 

Graph is marked dirty if variable was used during graphing. 
All global memory pointers are adjusted. 

Error if the variable resides in the archive. 


; Delete the variable 

'A' if it exists 


LD 

HL, AName 


RST 

rMov9ToOPl ; 

OP1 = variable a 

r 

B_CALL 

FindSym ; 

look up 

JR 

C, Deleted ; 

jump if variable 


r 

created 

r 

B_CALL 

DelVar 


Deleted : 



AName : 



DB 

RealOb j , ' A 1 , 0 , 0 



TI-83 Plus Developer’s Guide 


12-26 


Third Release January 25, 2002 


System Routines — Memory 


DelVarArc 

Category: Memory 

Description: Deletes a variable from RAM or the archive. 

Inputs: 

Registers: HL = pointer to symbol table entry of variable to delete 
DE = pointer to start of data for variable 


Flags: 

B = archived status 

0 = RAM otherwise the ROM page in Flash for the variable 

None 

Others: 

Outputs: 

None 


Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

Variable’s symbol entry and data deleted if in RAM, otherwise the symbol table 
entry is only deleted and the variable data is marked for deletion on the next 
garbage collection. 

Graph is marked dirty if variable was used during graphing. 

All global memory pointers are adjusted. 

All 

Remarks: 

Example: 

See DelVar and DelVarNoArc routines. 
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DelVarNoArc 


Category: Memory 

Description: Deletes variable from RAM. 

No archive checking performed. 

Inputs: 

Registers: HL = pointer to symbol table entry of variable to delete 
DE = data pointer to data 

Flags: None 

Others: None 


Outputs: 

Registers: None 

Flags: Regraph flag set if varGraphRef flag of symbol was set. 

Others: None 


Registers 

destroyed: 

Remarks: 


Example: 


All 


See DelVar for more information. 

This routine should only be called if you are sure that your variable will never 
be archived. Generally, it is better to use the DelVarArc or DelVar routines. 


Variable’s symbol entry and data are deleted. 

Graph is marked dirty if variable was used during graphing. 
All global memory pointers are adjusted. 

Error if the variable resides in the archive. 


; Delete the variable 
LD 
RST 

r 

B_CALL 

JR 


B_CALL 

Deleted : 

Aname : 

DB 


'A' if it exists: 
HL, Aname 
rMov9ToOPl 

FindSym 
C, Deleted 

DelVarNoArc 


RealOb j , ' A 1 , 0, 0 


OP1 = variable a 
look up 

jump if variable is not 
created 


TI-83 Plus Developer’s Guide 


12-28 


Third Release January 25, 2002 


System Routines — Memory 


EditProg 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

Remarks: 


Example: 


Memory 

This routine will insert all of free RAM into a Program, Equation, or AppVar. 
The intent is for the variable to be able to be edited without having to 
continuously allocate and deallocate memory. Once the edit is completed, a 
call to CloseProg is made to return what is not used back to free RAM. 


DE = pointer to start of variables data storage area 

None 

None 


None 

None 

Each of following are two-bytes: 

(iMathPtrl ) = pointer to the start of the variables data storage area. 

THIS MUST STAY INTACT WHILE THE EDIT IS IN SESSION. 


(iMathPtr2) 

(iMathPtr3) 

(iMathPtr4) 


pointer to the byte following the variable data. This is the next 
location the data area can grow into. 

pointer to the byte AFTER the last byte of free RAM inserted. 
The data being input cannot be written into this RAM location. 

size of RAM block moved to allow the RAM to be inserted. 

DO NOT CHANGE THIS VALUE. 


All 


The application can must change the pointer value in (iMathPtr2) as the 
variables data size grows or shrinks. This value is needed by the close routine. 

No memory allocation/deallocation can be done in this state. 

Contents of variables may by copied or changed, but not their sizes. 

The Floating Point Stack may be copied to/from, but not grown or shrunk. 

The hardware stack may change, calls, RET, push, and pop. 
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EnoughMem 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Memory 

Checks if an imputed amount of RAM is available. This routine will also 
attempt to free RAM that is taken by temporary variables that have been 
marked dirty but not yet deleted. 

HL = amount of RAM to check for being available 

None 

None 

DE = amount of RAM to check for being available 
CA = one (set) if there is insufficient RAM available 
None 
All 

None 

No error is generated. 

See MemChk. 
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Exch9 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Memory 

Exchanges (swaps) two nine-byte blocks of memory. 

DE = address of start of one nine-byte block 
HL = address of start of second nine-byte block 

None 

None 


None 

None 

Nine bytes originally at DE are now at original HL 
Nine bytes originally at HL are now at original DE 

A, BC, DE, HL 


None 
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ExLp 


Category: 

Description: 

Inputs: 

Registers: 


Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Memory 

Exchanges blocks of memory of up to 256 bytes. 


B = number of bytes; 0 = 256 

DE = address of start of one nine-byte block 

HL = address of start of second nine-byte block 

None 

None 

None 

None 

Block originally at DE is now at original HL 
Block originally at HL is now at original DE 

A, BC, DE, HL 


None 
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FindAlphaDn 

Memory 


Category: 

Description: 


This is used to search the symbol table, for all of the variables of a certain 
type, alphabetically in descending order. 

Each call to this routine returns the variable name preceding the one input in 
OP1. 


Inputs: 

Registers: None 
Flags: None 

Others: 


OP1 = variable name to find the previous before, usually output from the last 
call to this routine. 

(OP1) must have the type of variable searching for set. 

The name input in order to have the very last name for a certain type varies by 
the variable’s type: 

Real, Complex, Programs, AppVars, Group Vars: 


OP1 

+1 

+2 

+3 

+4 

+5 

+6 

+7 

+8 

Object 

Type 

OFEh 

? 

? 

? 

? 

? 

? 

? 


All other types: 


OP1 

+1 

+2 

+3 

+4 

+5 

+6 

+7 

+8 

Object 

Type 

variable 

token 

OFEh 

? 

? 

? 

? 

? 

? 


Outputs: 

Registers: If a previous variable name is found then: 

HL = pointer to the symbol table entry of the variable found 

CA = 0 if a previous variable name was found 
= 1 if no previous variable name exists 


Flags: 


Others: If a previous variable name is found then: 

OP1 and OP3 = the variable name found 


Registers 

destroyed: 


Otherwise : 

OP1 = variable name input 
All 


(continued) 
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FindAlphaDn (continued) 


RAM used: 


Remarks: 


Example: 


OP2, OP3 

upDownPtr — two byte pointer 

ProgObj, ProtProgObj, and TempProgObj are grouped together. 

ListObj and CListObj are grouped together. 

NewEquObj and EquObj are grouped together. 

See FindAlphaUp, SrchVLstUp, SrchVLstDn. 

Find all of the programs that are currently created, search alphabetically in 
descending order. 


FindPrograms : 


FindLoop : 


B_CALL 

ZeroOPl 


LD 

A, ProgObj 


LD 

(OP1) ,A 

; looking for a list 

LD 

A, OFEh 

; name = FEh, so the last 
; program alphabetically is 
; found 

LD 

(OP1+1) , A 


B_CALL 

FindAlphaDn 

; see if find another program 

; name 

RET 

C 

; return if no more program 
; names found yet 

list name 

JR 

FindLoop 

; find previous using one just 


found as input 
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FindAlphaUp 


Category: Memory 

Description: This is used to search the symbol table, for all of the variables of a certain 

type, alphabetically in ascending order. 

Each call to this routine returns the next variable name following the one input 
inOPI. 


Inputs: 

Registers: None 
Flags: None 

Others: OP1 = variable name to find the next after, usually output from the last call to 

this routine. 


(OP1) must have the type of variable searching for set. 

The name input in order to have the very first name for a certain type varies by 
the variable’s type: 

Real, Complex, Programs, AppVars, Group Vars: 


OP1 

+1 

+2 

+3 

+4 

+5 

+6 

+7 

+8 

Object 

Type 

00 

? 

? 

? 

? 

? 

? 

? 


All other types: 


OP1 

+i 

+2 

+3 

+4 

+5 

+6 

+7 

+8 

Object 

Type 

variable 

token 

OFFh 

? 

? 

? 

? 

? 

? 


Outputs: 

Registers: If a next variable name is found then: 

HL = pointer to the symbol table entry of the variable found 

Flags: CA = 0 if a next variable name was found 

= 1 if no next variable name exists 

Others: If a next variable name is found then: 

OP1 and OP3 = the variable name found 

Otherwise: 

OP1 = variable name input 

Registers All 

destroyed: 

(continued) 
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FindAlphallp (continued) 

RAM used: OP2, OP3 

upDownPtr — two byte pointer 

Remarks: ProgObj, ProtProgObj and TempProgObj are grouped together. 

ListObj and CListObj are grouped together. 

NewEquObj and EquObj are grouped together. 

See FindAlphaDn, SrchVLstUp, SrchVLstDn. 

Example: Find all of the lists that are currently created, search alphabetically in 


ascending order. 



FindLists : 

B_CALL 

ZeroOPl 



LD 

A, ListObj 



LD 

(OP1) ,A 

; looking for a list 


LD 

A, tVarLst 

; list designator token 


LD 

(OP1+1) , A 

r 


LD 

A, OFFh 

; set name to FFh, so that the 
; first list alphabetically is 
; found 


LD 

(OP1+1) , A 


FindLoop : 

B_CALL 

FindAlphaUp 

; see if find another list name 


RET 

C 

; return if no more list names 
; not found yet 


; 0P1 = next list name 


JR FindLoop ; find next using one just found 

; as input 
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FindApp 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Memory 

Searches for an application that may be stored in Flash ROM. 

None 

None 

OP1 = name of application to search for 

A = ROM page application starts on if found 

CA = 0 if application exists 

CA = 1 if application does not exist 

None 

All 

appSearchPage (two-bytes) 
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FindAppNumPages 

Category: Memory 


Description: 

Finds the number of 16K pages an application uses in archive memory 

Inputs: 

Registers: 

A = first page of application 

Flags: 

None 

Others: 

None 

Outputs: 

Registers: 

A = first page of application 

C = number of 16K pages the application uses 

Flags: 

None 

Others: 

None 

Registers 

BC, DE 

destroyed: 

Remarks: 

If an application was not found on the given page, C will equal 0. 

Example: 

IN A, (memPageAPort ) ; gets the current memory 

; page for app. Make sure 
; this is on the first page 
; of a multi-page 
; application. 

B_CALL FindAppNumPages ; finds the total number of 

; pages the application 
; uses in archive memory. 

LD A, C ; A — number of pages 

For multi-page apps, create a routine that will reside on the first page of the 
application that will return the memory page, 
i.e., Get_First_Page: 

IN A, (memPageAPort) ; get the memory page of 


; the first application 
; page . 


RET 
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FindAppDn 


Category: 

Description: 

Inputs: 

Memory 

Searches for the next application in Flash ROM whose name is alphabetically 
less than the name in OP1 . 


Registers: None 
Flags: None 


Others: 

OP1 = the name to find an application less than 

If searching for all of the application names in descending alphabetical order 
then this name is either the previous one found or the initial name used to start 
the search. 

Outputs: 

To initialize the search to find the last application name alphabetically, set 
(OP1 + 1) = 0FEh. 


Registers: None 

Flags: CA = 1 if no application with a lesser name exists. The previous found is the 


Others: 

Registers 

destroyed: 

first alphabetically. 

CA = 0 if an application less than OP1 was found. 

OP1 = application name found if one exists. 

All 

RAM used: 

Remarks: 

Example: 

OP2, OP3, appSearchPage (two-bytes) 

No information about what ROM page the application resides on is returned. 

To get this information a FindApp needs to be done. 

A loop that finds all of the application names in descending order. 


B_CALL ZerroOPl ; initialize OP1 for 1st search 

LD A, OFEh 

LD OPl+l),A ; set OP1 = name > any valid 

; name 


loop : 

B_CALL FindAppDn ; look for next lesser 

; alphabetically 

JR NC, loop ; jump if found one, go look for 

; next one 


r 

RET 
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FindAppUp 


Category: 

Description: 

Memory 

Searches for the next application in Flash ROM whose name is alphabetically 
greater than the name in OP1 . 

Inputs: 



Registers: None 
Flags: None 


Others: 

OP1 = the name to find an application greater than 

If searching for all of the application names in ascending alphabetical order 
then this name is either the previous one found or the initial name used to start 
the search. 

To initialize the search set OP1 = all 0’s with a system call to ZeroOPI . 

Outputs: 



Registers: None 

Flags: CA = 1 if no application with a greater name exists. The previous found is the 


Others: 

last alphabetically. 

CA = 0 if an application greater than OP1 was found 

OP1 = application name found if one exists 

Registers 

destroyed: 

RAM used: 

All 

OP2, OP3, appSearchPage (two-bytes) 

Remarks: 

No information about what ROM page the application resides on is returned. 

To get this information a FindApp needs to be done. 

Example: 

A loop that finds all of the application names in ascending order. 

B_CALL ZerroOPl ; initialize OP1 for 1st search 

loop : 

B_CALL FindAppUp ; look for next higher 

; alphabetically 

JR NC, loop ; jump if found one, go look for 

; next one 

r 

RET 
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FindSym 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Memory 

Searches the symbol table structure for a variable. 

This search routine is used to find variables that are not programs, AppVar, or 
Groups. See ChkFindSym. 

This is used to determine if a variable is created and also to return pointers to 
both its symbol table entry and data storage area. 

This will also indicate whether or not the variable is located in RAM or has 
been archived in Flash ROM. 


(OP1 + 1) to (OP1 + 6) = variable name 

See documentation on variable naming conventions. 

None 

None 


CA flag = 1 if symbol was not found 
= 0 if symbol was found 

If symbol is found, additional outputs are: 

ACC lower 5 bits = data type 

ACC upper 3 bits = system flags about variable. Mask via “AND” with a 
value of 1 Fh to obtain data type only. 

B = 0 if variable is located in RAM else variable is archived 
B = ROM page located on 

If variable is archived then its data cannot be accessed directly, it 
must be unarchived first. 

HL = pointer to the start of the variables symbol table entry 
DE = pointer to the start of the variables data area if in RAM 

None 

OP1 = variable name 
All 


This will not find system variables that are preallocated in system RAM such 
as Xmin, Xmax etc. Use RcISysTok to retrieve their values. 

This will not find applications. 

(continued) 


TI-83 Plus Developer Guide 


12-41 


Third Release January 25, 2002 


System Routines — Memory 


FindSym (continued) 

Example: ; Look for List LI in the symbol table. 

; If it exists and is archived then unarchive it and relook it up. 


; If it does 

not exist 

create it as a real 

list of 10 elements. 

Relook : 





LD 

HL, Llname 



B_CALL 

Mov9ToOPl ; 

OP1 = variable name 


B_CALL 

FindSym ; 

look up 


JR 

NC, VarCreated ; 

jump if it exists 

r 

LD 

HL, 10 

size to create at data 


B_CALL 

CreateRList 



PUSH 

HL 



PUSH 

DE ; 

save during move 


B_CALL 

OP4ToOPl ; 

OP1 = name 


POP 

DE ; 

restore 


POP 

HL 



JR 

Done 


r 

VarCreated : 





LD 

A, B 

check for archived 


OR 

A 

in RAM ? 


JR 

Z, DONE ; 

yes 

r 

B_CALL 

Arc_Unarc ; 

unarchive if enough RAM 


JR 

Relook ; 

look up pointers again . 



/ 

RAM now 

DONE : 





RET 



r 

Llname : 





DB 

Li st Ob j , tVarLst , tLl , 0 
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FixTempCnt 


Category: 

Description: 

Inputs: 

Memory 

Resets pTempCnt back to a input value, and delete all temps with name 
counters greater than or equal to that value. 


Registers: DE = value to pTempCnt to 
Flags: None 

Others: None 

Outputs: 

Registers: None 
Flags: None 


Others: 

Registers 

destroyed: 

(pTempCnt) = DE 

All temps created with pTempCnt >= input DE are deleted. For example, if 
input DE = 5 then temps with counter value 5 or greater $0500 will be deleted 
$0600... 

All 

RAM used: 

Remarks: 

Example: 

pTempCnt 

See the Temporary Variables section in Chapter 2. Also, see the CleanAII 
routine. 
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FlashToRam 

Category: Memory 

Description: Copies bytes from Flash to RAM 

Inputs: 

Registers: A = page of source (Flash) 

HL = offset of source (Flash) 


Flags: 

DE = RAM location of destination 

BC = number of bytes to copy 

None 

Others: 

Outputs: 

None 


Registers: None 
Flags: None 


Others: 

None 

Registers 

destroyed: 

Remarks: 

Example: 

Certain pages in Flash cannot be copied. This routine will wrap to the next 
page if the offset = 8000h. A will be incremented to the next page, and HL will 
be reset to 4000h, and the copying will go on. 


TI-83 Plus Developer’s Guide 


12-44 


Third Release January 25, 2002 


System Routines — Memory 


InsertMem 


Category: 

Description: 

Inputs: 

Memory 

Inserts RAM into an existing variable. 

This routine will only insert the RAM — it stays uninitialized and if the variable 
inserting into has a size field, it is NOT UPDATED. Updating must be done by 
the application. 

A check for enough free RAM must be done by the application. This routine 
assumes the RAM is available. 


Registers: HL = number of bytes of RAM to insert, no check is made for enough free 
RAM. 



DE = point of insertion address — this cannot be the first byte of the variable’s 
data — if it is, its symbol table entry will not have the correct pointer to 
the data. 

Flags: 

None 

Others: 

Outputs: 

None 


Registers: DE = intact, the point of insertion address 
Flags: None 


Others: 

RAM inserted into variable. 

Registers 

destroyed: 

All 

Remarks: 

See DelMem. 


(continued) 
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InsertMem (continued) 

Example: Insert 10 bytes at the beginning of an Application Variable. 



LD 

HL, 10 

; number bytes to insert 


B_CALL 

ErrNotEnoughMem 

; error if 10 bytes are not 
; free 

r 

LD 

HL, AppVarName 



RST 

rMov9ToOPl 

; OP1 = name of AppVar 


B_CALL 

ChkFindSym 

; look up in symTable 


JR 

NC, Created 

; jump if it exists 

r 

B JUMP 

ErrUndef ined 

; error if not there 

r 

; DE = pointer to size 

bytes of AppVar 


r 

Created : 

PUSH 

DE 

; save pointer to start of 
; size bytes of data 

r 

INC 

DE 



INC 

DE 

; move DE past size bytes 

t 

LD 

HL, 10 

; number bytes to insert 


B_CALL 

InsertMem 

; insert the memory 

r 

POP 

HL 

; HL = pointer to size byte 


PUSH 

HL 

; save 

r 

B_CALL 

LdHLInd 

; HL = size of AppVar, 

; number bytes 


LD 

BC, 10 



ADD 

HL, BC 

; increase by 10, amount 
; inserted 

t 

EX 

DE, HL 



POP 

HL 

; pointer to size bytes 
; location 

r 

LD 

(HL) , E 



INC 

HL 


r 

LD 

(HL) , D 

; write new size. 

r 

AppVarName : 

DB 

AppVarOb j , 'AVAR' 

,0 
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LdHLInd 


Category: Memory 

Description: Loads register pair HL with the contents of memory pointed to by (HL). 

Inputs: 

Registers: HL = address. 

Flags: None 

Others: None 

Outputs: 

Registers: H = (HL+1) 

L = (HL) 

Flags: None 

Others: None 

Registers A, HL 

destroyed: 

Remarks: 

Example: Same as: 


LdHLInd: 


LD 

A, 

(HL) 

INC 

HL 


LD 

H, 

(HL) 

LD 

L, 

A 

RET 
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LoadCIndPaged 


Category: 

Description: 


Inputs: 

Registers: 


Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Memory 

Reads a byte of data from any ROM page. Main use is for applications to read 
data from variables that are archived, without having to unarchive them to 
RAM first. 


B = ROM page to read byte from 
HL = address of byte on the ROM page, 
(4000h-7FFFh) 

None 

None 


C = byte of data from input ROM page and Offset 

None 

None 

C 

B, HL are not changed. See the LoadDEIndPaged routine. Also, see the 
Accessing Archived Variables Without Unarchiving section in Chapter 2. 

Read the byte of data from ROM page OCh, address 4006h. 


LD 

B, Och 

; ROM page 

LD 

HL, 4 00 6h 

; offset 

B_CALL 

LoadCIndPaged 

; C = byte 

RET 
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LoadDEIndPaged 


Category: 

Description: 


Inputs: 

Registers: 


Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Read two consecutive bytes of data from any ROM page. The main use of this 
routine is for applications to read data from variables that are archived, without 
having to unarchive them to RAM first. 


B = ROM page of first of two bytes to read 
HL = address of byte on the ROM page, 
(4000h-7FFFh) 

None 

None 


E = first byte read 
D = second byte read 

None 

None 

DE, C 

B, HL are set to the address of the second byte read. If the second byte of 
data is not on the same ROM page as the first, the switch to the next ROM 
page is handled. See the LoadCIndPaged routine. Also, see the Accessing 
Archived Variables Without Unarchiving section in Chapter 2. 

Read two bytes of data from ROM page OCh, address 4006h. 


LD 

B, Och 

; ROM page 


LD 

HL, 4 00 6h 

; offset 


B_CALL 

LoadDEIndPaged 

; D = byte @ 

(4007h) 



; E = byte @ 

(4006h) 
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MemChk 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Memory 

Returns the amount of RAM currently available. 

None 

None 

None 


HL = amount of RAM available, in bytes 

None 

None 

BC, HL 


If a system editor is open, this will always return 0 bytes available. System 
edits use all of free RAM during the edit. 

The amount returned may be inaccurate if there are any temporary variables 
that are marked as dirty but not yet deleted. There are two ways/options to 
solve this: 

- The routine CleanAII can be used to remove all temporary 
variables. This is fine as long as an application is not using 
temporary variables. Temporary variables are returned by the 
parser if the result is not RealObj or CpIxObj, make sure that 
none are still in use. 

Use the routine EnoughMem instead, it will delete only temps 
that are marked dirty. 

Delete all temporary variables and then check if there is at least 100 bytes 
available. 


B_CALL 

CleanAII 

; delete all temporary 
; variables 

B_CALL 

MemChk 

; HL = amount of mem free 

LD 

DE, 100 


OR 

A 

; CA = 0 

SBC 

HL, DE 

; if CA = 1 then less than 100 
; bytes are available 

JR 

C, Not_100 

; j ump if < 100 
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PagedGet 


Category: Memory 

Description: Used for reading data from the archive with the Caching technique. This 

routine will return the next byte and also refill the cache when it is emptied. 

A call to the SetupPagedPtr routine must be done once before using this 
routine to retrieve data from the archive. 


Inputs: 

Registers: None 
Flags: None 

Others: These are initially set by the SetupPagedPtr routine and are updated each 

time a call is made to the PagedGet routine. Applications do not need to 
modify these RAM locations. 

(pagedPN) = current Flash page. 

(pagedGetPtr) = current Flash address. 


Outputs: 

Registers: ACC = byte read 
Flags: None 

Others: None 


Registers 

destroyed: 

Remarks: 


Example: 


ACC 

Crossing ROM page boundaries is handled. See the SetupPagedPtr, 
LoadCIndPaged, and LoadDEIndPaged routines. Also, see the Accessing 
Archived Variables Without Unarchiving section in Chapter 2. 


LD 

B, PageToGet 


LD 

DE, AddressToGet 


B_CALL 

SetupPagedPtr 

; setup paged get 

B_CALL 

PagedGet 

; ACC = byte from archive 

LD 

E, A 

; E = byte 

B_CALL 

PagedGet 

r 

LD 

D, A 

; DE = 2 bytes read from 
; archive 
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RCIGDB2 


Category: Memory 

Description: Recalls graph database. 

Inputs: 

Registers: A = tVarGDB 
Flags: None 

Others: OP1 = data base name 

(chkDelPtrl) contains data pointer 

Outputs: 

Registers: None 

Flags: None 

Others: None 


Registers 

destroyed: 

Remarks: 


Example: 


Acts exactly as the user controlled RcIGDB command: Restores graph mode 
stored in the GDB and replaces all equation variables with those stored in the 
GDB and all range values with those stored in the GDB. 

; Restore GDB2 if it exists: 


B_CALL 

ZeroOPl 

; zero out OP1 

LD 

HL, GDB2Name 

; name -> OP1 

LD 

DE, OP1 


LD 

BC, 03 


LDIR 



B_CALL 

FindSym 

; find & point to symbol . 

RET 

C 

; abort if does not exist 

B_CALL 

RclGDB2 

; restore graph data base 

DB 

GDBObj, tVarGDB, tGDB2 (008h, 061h, OOlh) 
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RcIN 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Memory 

Recalls the contents of variable N if it exists. 

None 

None 

None 

None 

None 

System error if N does not exist. 

OP1 = contents of N if RealObj 
OP1/OP2 = contents of N if CpIxObj 


Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


All 

OP1 -OP2 
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RcIVarSym 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Memory 

Recalls the contents of variable A - Z or THETA. 

None 

None 

OP1 = name of variable to recall 

None 

None 

System error if variable does not exist. 

If a variable other than A - Z or THETA, then nothing is done. 

OP1 = contents of variable if RealObj 
OP1/OP2 = contents of variable if CpIxObj 


Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


All 

OP1 -OP2 
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RclX 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Memory 

Recalls the contents of variable X if it exists. 

None 

None 

None 

None 

None 

System error if X does not exist. 

OP1 = contents of X if RealObj 
OP1/OP2 = contents of X if CpIxObj 


Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


All 

OP1 -OP2 
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RclY 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Memory 

Recalls the contents of variable Y if it exists. 

None 

None 

None 

None 

None 

System error if Y does not exist. 

OP1 = contents of Y if RealObj 
OP1/OP2 = contents of Y if CpIxObj 


Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


All 

OP1 - OP2 
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RedimMat 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 


Example: 


Memory 

Redimensions an existing matrix. 

HL = new dimension of matrix wanted 
None 

OP1 = name of matrix 

None 

None 

None 

All, iMathPtrl, insDelPtr 
OP1, OP3 

If not enough room, then a memory error will occur. 

The space is allocated/deallocated. The pointers are adjusted accordingly. All 
the new elements are set to 0. The old values of the elements that are not 
removed are kept. A Matrix cannot be modified if it is archived. 


skip : 
MatrixA: 


B_CALL 

ZeroOPl 

r 

zero out OP1 

LD 

HL, MatrixA 



LD 

DE, OP1 



LD 

BC, 3 



LDIR 


f 

load matrix name into OP1 

B_CALL 

ChkFindSym 

r 

find matrix variable name 

JR 

C, skip 

r 

if not found, skip over wo 

LD 

A, B 

r 


OR 

A 

r 

see if archived 

JR 

NZ, skip 

r 

skip if variable archived 

LD 

HL, 0505h 

r 

redimensionalize matrix to 

B_CALL 

RedimMat 



RET 




DB 

MatOb j , tVarMat 

MatA 
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SetupPagedPtr 


Category: Memory 

Description: Initializes the process of reading data from the archive using the caching 

method. 

The PagedGet routine is used to read data from the archive after this 
initialization routine is called. 


Inputs: 

Registers: Start address of the first byte of data to be read 
B = ROM page of the first byte 
DE = address of first byte, on the ROM page 
(4000h-7FFFh) 

Flags: None 

Others: None 


Outputs: 

Registers: None 
Flags: None 

Others: These outputs are inputs to the PagedGet routine. An application should not 

change these values directly. 

pagedCount = 0 on first call 
pagedPN = current Flash page 
pagedGetPtr = current Flash address 

Registers None 

destroyed: 


Remarks: See the PagedGet routine. Also, see the Accessing Archived Variables 

Without Unarchiving section in Chapter 2. 


Example: 


LD 

B, PageToGet 


LD 

DE, AddressToGet 


B_CALL 

SetupPagedPtr 

; setup paged get 

B_CALL 

PagedGet 

; ACC = byte from archive 

LD 

E, A 

; E = byte 

B_CALL 

PagedGet 

r 

LD 

D, A 

; DE = 2 bytes read from 
; archive 


TI-83 Plus Developer’s Guide 


12-58 


Third Release January 25, 2002 


System Routines — Memory 


SrchVLstDn, SrchVLstUp 


Category: Memory 

Description: Searches the I/O var list in the backward/forward direction, next lower 

alphabetically, and by type in the following order: 


PROG RAM, ProtPtrg 

05h,06h 

DATABASE 

08h 

PICTURE 

07h 

LIST.CIist 

01 h,0Dh 

MATRIX 

02h 

YVARS 

03h 

AppVars 

15h 

Group 

17h 

WINDOW 

OBh 

ZSTO 

OCh 

TABLE RANGE 

ODh 

REAL 

OOh 

Cplx 

OCh 

String 

04h 

Apps 

14h 


Inputs: 


Registers: 

Flags: 

Others: 

Outputs: 


OP1 = last name and type found in variable format 

inGroup, (IY + groupFlags) should be reset 
inDelete, (IY + ioDelFlag) should be reset 

(varClass) should be set to 9 to search through the entire list. 


Registers: 

Flags: 

Others: 

Registers 

destroyed: 


HL = pointer to symbol table entry if found 

CA = 0 if found 

CA = 1 if did not find anything 

OP1 = var format of next variable if found 

All registers 


Remarks: 


This calls FindAlphaUp/FindAlphaDn to find variables within each variable 
type. 


Example: 
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StMatEI 


Category: 

Description: 

Inputs: 

Memory 

Stores an element to a matrix. Convert matrix or element to complex if 
necessary. 


Registers: BC = column number 
DE = row number 


Flags: 

None 

Others: 

Outputs: 

OP1 = existing matrix variable name 

FPST = value to store (real or complex) 


Registers: None 

Flags: graphDraw set if graph reference flag was on 


Others: 

OP1 = value originally on FP stack 

FPST was popped, value no longer on FPST 

Value was stored to the matrix 

Registers 

destroyed: 

Remarks: 

Example: 

All 
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StoAns 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 


Memory 

Stores OP1 to Ans variable. 

None 

None 

OP1[,OP2] = value if real [complex] 

Otherwise OP1 = name of variable that contains the data to store into Ans 


Outputs: 

Registers: None 

Flags: None 

Others: Data stored if possible 

OP1[,OP2] = original contents it real[complex] 
else OP1 = Ans variable name 


Registers FPS, OP1 , OP2, OP4 
destroyed: 

Remarks: If input was a parser temporary ($P) variable, it is marked dirty (to be deleted 

by memory management). 

A memory error occurs if there is not enough room to store the value. 

Ans is the same system variable that is found by pressing [2nd] [Ans] on the 
calculator keyboard. 

Use RclAns to recall the contents of Ans. 


Example: 
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StoGDB2 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Memory 

Stores the current graph mode settings and equations into a system graph 
database variable. 


None 

None 

OP1 = graph database name to store to 

None 

None 

GDB created or modified 
All 

(ioData) buffer used to store name temporarily. 

This creates the graph database if it did not exist already. If it did exist, it is 
resized to fit the size of the variables to be stored. 
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StoN 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 


Example: 


Memory 

Stores OP1 to sequence variable n. 

None 

None 

OP1 = a real number, positive integer 


None 

None 

Sets chkDelPtr3 = system table pointer 
Sets chkDelPtrl = data pointer 

All 

OP1, OP2, OP4 

This does not store to variable N. 

This will store to the system variable n used in Sequence graphing. 
To recall, see RcIN. 
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StoOther 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 


Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 


Memory 

General purpose routine that stores data to user created variables that are not 
of type ProgObj, GDBObj, GroupObj, AppObj or PictObj. 

Also, this routine should not be used to store to system variables such as 
Xmin. 


None 

None 

OP1 = name and type of variable to store to. 

(OP1) = data type, followed by the name. 

FPST = data to store if not storing to CpixObj 
FPS1/FPST = data to store if storing to CpixObj 

If the variable storing to is RealObj or CpixObj, then the data storing CANNOT 
be another variable. The FPS must contain the literal data stored. 

If the variable storing to is not RealObj or CpixObj, then the data storing MUST 
be another variable. This variable can either be user created or a temporary 
variable returned by the parser after executing an expression. 

If the variable storing to is already created, then it must reside in RAM and not 
the archive. 


None 

Both the graph and the table can be marked dirty if the variable stored to was 
used in a graph equation. 

Error if the data is not the correct type to be stored to the variable — for 
example, store list data to a matrix. 

Error if the variable storing to is archived. 

Error if not enough memory. 

If no errors: 

If the variable storing to was not created on input, this routine will create it. 
Data stored to the variable. 

OP1/OP2 = data that was stored. 

The data is removed from the FPS. 

All 
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StoOther (continued) 


Remarks: 

Example: 


See the StoSysTok routine. See Chapter 2 for Error Handlers and Floating 
Point Stack. 

Store list LI to list L3. 


Llname : 


LD 

HL, Llname 

B_CALL 

Mov9ToOPl 

B_CALL 

PushRealOl 

LD 

A, tL3 

LD 

(OP1+2 ) , A 

B_CALL 

StoOther 

RET 



; 0P1 = LI name 
; FPST = LI name 

; token for L3 
; change 0P1 to L3 name 

; store LI -> L3 


DB ListObj, tVarLst, tLl, 0 
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StoR 


Category: Memory 

Description: Stores OP1 [,OP2] -> user variable R. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = real value to store 

or 

OP1/OP2 = complex value to store 


Outputs: 

Registers: None 
Flags: None 

Others: Sets chkDelPtr3 = system table pointer 

Sets chkDelPtrl = data pointer 


Registers All 

destroyed: 

RAM used: 0P1.0P2, OP4 

Remarks: Note that there is not a RclR routine, but one can be made by: 


Example: 


B_CALL RName 

B_CALL RclVarSym 

This sets R to 1 : 

B_CALL OPISetl 

B_CALL StoR 

RET 


set OP1 to R name 
do recall 


INIT R = 1 
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StoSysTok 


Category: Memory 

Description: Stores a value in OP1 to system variable specified by token number in the 

accumulator. 


Inputs: 


Registers: A = system variable token number 
OP1 = real number to save 

Flags: None 

Others: None 

Outputs: 

Registers: OP1 = contents of system variable 

Flags: None 

Others: None 

Registers 

destroyed: 

Remarks: 


Example: 


B_CALL 

OPlSet3 

; Store -3 into Xmin 
; register OP1 = floating point 3 

B_CALL 

InvOPIS 

; negate FP number in 

OP1, 

LD 

A, XMINt 

; OP1 = -3 

; ACC = Xmin variable 

token value 

B_CALL 

StoSysTok 

; store OP1 to Xmin, 
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StoT 


Category: Memory 


Description: 

Inputs: 

Stores OP1 [,OP2] to user variable T. 


Registers: 

None 


Flags: 

None 


Others: 

OP1 = real value to store 

or 

OP1/OP2 = complex value to store 


Outputs: 



Registers: 

None 


Flags: 

None 


Others: 

Sets chkDelPtr3 = system table pointer 
Sets chkDelPtrl = data pointer 


Registers 

destroyed: 

All 


RAM used: 

OP1, OP2, OP4 


Remarks: 

Note that there is not a RcIT routine, but one can be made by: 


B_CALL TName 

B_CALL RclVarSym 

; set OP1 to T name 
; do recall 

Example: 

r 

B_CALL StoT 

RET 

; This sets T to 0 . : B_CALL 

; OPISetO 
; INIT T = 0 
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StoTheta 


Category: Memory 

Description: Stores OP1 [,OP2] to user variable Theta. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = real value to store 

or 

OP1/OP2 = complex value to store 


Outputs: 

Registers: None 
Flags: None 

Others: Sets chkDelPtr3 = system table pointer 

Sets chkDelPtrl = data pointer 


Registers All 
destroyed: 


RAM used: 
Remarks: 


Example: 


OP1, OP2, OP4 

Note that there is not a RcITheta routine, but one can be made by: 


B_CALL 

ThetaName 

; set OP1 to 

Theta 

B_CALL 

RclVarSym 

; do recall 


Theta to 2 . . 




B_CALL 

OPlSet2 



B_CALL 

StoTheta 

; INIT Theta 

= 2 

RET 
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StoX 


Category: Memory 

Description: Stores OP1 [,OP2] to user variable X. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = real value to store 

or 

OP1/OP2 = complex value to store 


Outputs: 

Registers: None 
Flags: None 

Others: Sets chkDelPtr3 = system table pointer 

Sets chkDelPtrl = data pointer 


Registers All 

destroyed: 

RAM used: 0P1.0P2, OP4 

Remarks: See RclX to recall contents of X. 

Example: 


B_CALL OP 1 Set 2 

B_CALL StoX 

RET 


; This sets X to 2 : 
; INIT X = 2 
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StoY 


Category: Memory 

Description: Stores OP1 [,OP2] to user variable Y. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = real value to store 

or 

OP1/OP2 = complex value to store 


Outputs: 

Registers: None 
Flags: None 

Others: Sets chkDelPtr3 = system table pointer 

Sets chkDelPtrl = data pointer 


Registers All 

destroyed: 

RAM used: OP1,OP2,OP4 

Remarks: See RclY to recall contents of Y. 

Example: 


B_CALL OP 1 Set 2 

B_CALL StoY 

RET 


; This sets Y to 2 : 
; INIT Y = 2 
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System Routines — 
Parser 


BinOPExec 
Five Exec... 
FourExec .. 
Parselnp ... 
RcISysTok 
ThreeExec 
UnOPExec 



13-1 


13-3 


13-5 


13-7 


13-9 

1 

3-10 

1 

3-12 
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BinOPExec 

Category: Parser 

Description: Executes functions that have two arguments as inputs. 

Inputs: 

Registers: ACC = function to execute (see table below) 

Flags: None 

Others: OP1 = second argument 

FPST = first argument (Floating Point Stack Top), see example 

Outputs: 

Registers: None 

Flags: None 


Others: 

OP1 = result 

Registers 

destroyed: 

All 

Remarks: 

Checks for valid argument types are done. 

The values pushed onto the FPS are removed. 

This entry point should only be used if direct access to a particular function is 
not available. 


It can also be used in cases of mixed argument types. Like the example below 
where a real is added to a list. 

Valid arguments can be obtained from the TI-83 Plus Guidebook. 

(continued) 
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BinOPExec (continued) 


Example: 

.5 + Ll 

LD 

RST 

B_CALL 

HL, Point5 

rMov9ToOPl 

PushOPl 

; OP1 = .5 

; OP1 -> FPST, or OP1/OP2 
; complex number 


r 

LD 

RST 

HL, Llname 

rMov9ToOPl 

; OP1 = Ll name 


r 

Llname : 

LD 

B_CALL 

DB 

A, OP Add ; function is addition 

BinOPExec ; OP1 = result of . 5 + Ll 

RListob j , tVarLst , tLl , 0 , 0 


BinOPExec equates and functions 


Equate 

Function 

Equate 

Function 

Equate 

Function 

OPBal 

bal ( 

OP Sum 

sum ( 

OPProd 

prod ( 

OPBinCdf 

binomedf ( 

OPBinPdf 

binompdf ( 

OPIrr 

irr ( 

OPFinNom 

>Nom ( 

OPFinEf f 

>Ef f 

OPFinDbd 

dbd ( 

OPRandNrm 

randNorm ( 

OPstDev 

stdDev ( 

OPVariance 

variance ( 

OPPrn 

iPrn ( 

OPIntr 

lint ( 

OPRandBin 

randBin ( 

OPNormalPdf 

normalpdf ( 

OPINormal 

invNorm ( 

OPNormal 

normalcdf ( 

OPPoiPdf 

poissonpdf ( 

OPPoiCdf 

poissonedf ( 

OPGeoCdf 

geometedf ( 

OPGeOPdf 

geometpdf ( 

OPChiPdf 

xypdf ( 

OPTpdf 

tpdf ( 

OPAdd 

+ 

OPSub 

- 

OPMult 

•k 

OPDiv 

/ 

OPPower 

A 

OPXroot 

xuy 

OPEq 

= 

OPRound2 

round ( 

OPConst 

Fill ( 

OPAug 

augment ( 

OPMax 

max ( 

OPMin 

min ( 

OP Lem 

1cm ( 

OPGcd 

ged ( 

tEvalF 

u (beg, end 

tMedian 

median ( 

tMean 

mean ( 

OPRandlnt 

randlnt ( 

OPAnd 

and 

OPOr 

or 

OPXor 

xor 

OPNcr 

nCr 

OPNpr 

nPr 

OPLt 

< 

OPLe 

< = 

OPGt 

> 

OPGe 

>= 

OPRandl 

randM ( 

OPInstr 

inString ( 

OPPxtst 

Pxl-Test ( 

OPRtOPr 

R>Pr ( 

OPRtOPo 

R>P0 ( 

OPPtorx 

P>Rx ( 


OPPtoRy P>Ry( 


Note: For tEvalF there are really three inputs but execution still goes through the entry 

point for two arguments. The Equation name needs to be pushed onto the FPS first, 
then the second argument and the third in OP1 . This is only valid in Sequential graph 
mode. 


The second argument is the start value. 
The third argument is the end value. 

A list of results is returned. 
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FiveExec 

Category: Parser 

Description: Executes functions that have five arguments as input. 

Inputs: 

Registers: ACC = function to execute (see table below) 

Flags: None 


Others: 

OP1 = fifth argument 

FPST = fourth argument (pushed onto FPS fourth) 

FPS1 = third argument (pushed onto FPS third) 

FPS2 = second argument (pushed onto FPS second) 

FPS3 = first argument (pushed onto FPS first) 


Outputs: 

Registers: None 
Flags: None 


Others: 

OP1 = result 

Registers 

destroyed: 

All 

Remarks: 

Checks for valid argument types are done. 

The values pushed onto the FPS are removed. 

This entry point should only be used if direct access to a particular function is 
not available. 

Valid arguments can be gotten from the TI-83 Plus Guidebook. 

( continued) 
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FiveExec ( continued ) 


Example: 


LD 

HL, Ylname 

; fin (Yl, X, 2, 4, .5) ; 



RST 

rMov9ToOPl 

; OP1 = Yl name 



B_CALL 

PushOPl 

; save to FPST; 



B_CALL 

XName 

; OP1 = X var name 



B_CALL 

PushOPl 

; push onto FPST, Yl -> FPS1 



B_CALL 

OPlSet2 

; OP1 = 2 



B_CALL 

PushOPl 

; push onto FPST, Yl -> FPS2 
; X -> FPS1 ; 



B_CALL 

OP 1 Set 4 

; OP1 = 4 



B_CALL 

PushOPl 

; — >FPST, Yl— >FPS3 , X->FPS2, 

; 2->FPSl, 4->FPST; 



LD 

HL, point5 




RST 

rMov9ToOPl 

; OP1 = .5; 



LD 

A, OPFmin 1 

; function is fMin ( 



B_CALL 

FiveExec 

; OP1 = result 


YlName : 

DB 

EquOb j , tVarEqu 

, tYl , 0, 0 


Point5 : 

DB 

0, 80h, 50h, 0, 0, 

o 

o 

o 

o 


FiveExec equates and functions 


Equate 

Function 

Equate 

Function 

Equate 

Function 

OPSeq 

OPFmax 

seq ( 
fMax ( 

OPQuad 

fnlnt ( 

OPFmin 

fmin ( 
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FourExec 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 


Parser 

Executes functions that have four arguments as input. 


ACC = function to execute (see table below) 

None 

OP1 = fourth argument 

FPST = third argument (pushed onto FPS third) 

FPS1 = second argument (pushed onto FPS second) 
FPS2 = first argument (pushed onto FPS first) 


Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


None 

None 

OP1 = result 
All 


Checks for valid argument types are done. 

The values pushed onto the FPS are removed. 

This entry point should only be used if direct access to a particular function is 
not available. 

Valid arguments can be obtained from the TI-83 Plus Guidebook. 

(continued) 
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FourExec (continued) 

Example: 





; nDeriv (Yl, X, 2, 


LD 

HL, YlName 




RST 

rMov9ToOPl 

; OP1 

= Yl name 


B_CALL 

PushOPl 

; save 

to FPST; 


B_CALL 

XName 

; OP1 

= X var name 


B_CALL 

PushOPl 

; push 

onto FPST, Yl 


B_CALL 

OPlSet2 

; OP1 

= 2 


B_CALL 

PushOPl 

; push 

onto FPST, Yl 




; x -> 

FPS1 ; 


LD 

HL, point5 




RST 

rMov9ToOPl 

; OP1 

= -5; 


LD 

A,OPDeriv81 ; function is nDeriv 


B_CALL 

FourExec 

; OP1 

= result 

YlName : 

DB 

EquOb j , tVarEqu, tYl , 0 , 

0 

Point5 : 

DB 

0, 80h, 50h, 

o 

o 

o 

o 

o 

o 


FourExec 

equates and 

functions 



Equate 

Function 

Equate 

Function 

Equate 

OPNpv 

npv ( 

OPNormal 

normalcdf ( 

OPMltRadd 

OPSeq 

seq ( 

OPQuad 

fnlnt ( 

OPDeriv81 


OPSolve 

OPDf 


solve ( 
Fcdf ( 


OPFmin 


fMin ( 


OPFmax 


) ; 

-> FPS1; 
-> FPS2 , 


Function 

*row+ ( 
nDeriv ( 
fMax ( 
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Parselnp 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Registers 

destroyed: 

Remarks: 


Parser 

Executes an equation or program stored in a variable. 

None 

None 

OP1 = name of equation or program to execute 

None 

None 

If executed an equation, then OP1 and Ans contain the result. 

If executed a program, then no result is returned. 

Errors will be generated during parsing — to avoid them from being displayed, 
install an error handler before parsing. 

All 

See the Parsing Function, Temporary Variables section in Chapter 2 for further 
information. 

(continued) 
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Parselnp (continued) 


Example: 


Parse the graph equation yl and store the answer in Y. Install an error handler 
around the parsing and the storing to catch any errors. 

RET CA = 0 if OK, else RET CA = 1 . 


LD HL,ylName 

RST rMov9ToOPl ; OP1 = yl name 


if an error while parsing go to this 
AppOnErr ErrorHan 

label 

; error handler installed, 

; (macro) 

B_CALL 

Parselnp 

; execute the equation 

returns if no error 



B_CALL 

JR 

CkOPIReal 

Z , storit 

; check if RealObj 
; jump if it is real 

AppOf fErr 


; remove the error handler 


; come here if any error was detected 
; error handler is removed when the error occurred 


ErrorHan : 

B_CALL CleanAll 

SCF 

RET 

r 

storit : 

B_CALL StoY 


AppOf fErr 

B_CALL CleanAll 


clean any temp vars created by 
parser 

CA = 1 signals failure 


store to Y, RET if no error, 
else ErrorHan 

remove error handler 

clean any temp vars created by 
parser 

CA = 0 for no error 


CP A 

RET 

ylName : 

DB EquOb j , tVarEqu, tYl , 0 , 0 
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RcISysTok 

Category: Parser 

Description: Recalls a value in system variable specified by token number in the 

accumulator to OP1 . 

Inputs: 

Registers: A = system variable token number 
Flags: None 

Others: None 

Outputs: 

Registers: OP1 = contents of system variable 

Flags: None 


Others: 

Registers 

destroyed: 

Remarks: 

None 

Example: 

LD A, XMINt 

B_CALL RcISysTok ; OP1 = contents of Xmin 
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ThreeExec 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 


Parser 

Executes functions that have three arguments as input. 


ACC = function to execute (see table below) 

None 

OP1 = third argument 

FPST = second argument (pushed onto FPS second) 
FPS1 = first argument (pushed onto FPS first) 


Outputs: 

Registers: None 

Flags: None 

Others: OP1 = result 

Registers All 

destroyed: 


Remarks: Checks for valid argument types are done. 

The values pushed onto the FPS are removed. 

This entry point should only be used if direct access to a particular function is 
not available. 

Valid arguments can be obtained from the TI-83 Plus Guidebook. 

(continued) 
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ThreeExec (continued) 

Example: ; row +( [A] , 1,2) 



LD 

HL, MatAName 





RST 

rMov9ToOPl 

; OP1 = 

[A] name 




B_CALL 

PushOPl 

; save 

to FPST; 




B_CALL 

OPISetl 

; OP1 = 

1 




B_CALL 

PushOPl 

; push 

onto FPST, 

mat name 




; moves 

to FPS1 ; 




B_CALL 

OPlSet2 

; OP1 = 

2; 




LD 

A, OPRAdd 

; function is row 

+ 



B_CALL 

ThreeExec 

; OP1 = 

result, a 

temp Matrix 




; variable 



MatAName : 

DB 

MatOb j , tVarMat , tMat A, 0 , 0 



ThreeExec 

equates and 

functions 





Equate 

Function 

Equate 

Function 

Equate 


Function 

OPPrn 

iPrn ( 

OPIntr 

lint ( 

OPBinpdf 


binompdf ( 

OPBincdf 

binomcdf ( 

OPIrr 

irr ( 

OPNpv 


npv ( 

OP Sum 

sum ( 

OPProd 

prod ( 

OPNormalPdf 

normalpdf ( 

OPRandNrm 

randNorm ( 

OPRandBin 

randBin ( 

OPRandlnt 


randlnt ( 

OPINormal 

invNorm ( 

OPInstr 

inString ( 

OPNormal 


normalcdf ( 

OPDt 

tcdf ( 

OPFpdf 

Fpdf ( 

Opchi 


x 2 cdf ( 

OPSubstr 

sub ( 

OPDeriv8 1 

nDeriv ( 

tEvalF 


Eval ( 

OPRadd 

row+ ( 

OPRswap 

rowSwap ( 

OPRmlt 


row* ( 

OPMltRadd 

*row+ ( 

OPSolve 

solve ( 





Note: For tEvalF there are really four inputs but execution still goes through the entry point 
for three arguments. The Equation name needs to be pushed onto the FPS first, then 
the second argument and then third, and then the fourth in OP1 . This is only valid in 
Sequential graph mode. 

The second argument is the start value. 

The third argument is the end value. 

The fourth argument is the step size. 

A list of results is returned. 


TI-83 Plus Developer Guide 


13-11 


Third Release January 25, 2002 


System Routines — Parser 


UnOPExec 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Parser 

Executes functions that have one argument as the input. 

ACC = function to execute (see table below) 

None 

OP1 = argument 

None 

None 

OP1 = result 
All 

This entry point should only be used if direct access to a particular function is 
not available. 

It is also useful to use this entry point when arguments are not simply real 
numbers. See example below. 

Valid arguments can be obtained from the 77-83 Plus Guidebook. 

(continued) 
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UnOPExec (continued) 





; sin (LI ) 




LD 

HL, Llname 





RST 

rMov9ToOPl 

; OP1 = LI 

name ; 



LD 

A, OPSin 

; function 

is addition 


B_CALL 

UnOPExec 

; OP1 = result of sin (LI) a 




; temp list variable 


Llname : 

DB 

RListOb j , tVarLst , tLl , 0 , 0 



UnOPExec equates and functions 




Equate 

Function 

Equate 

Function 

Equate 

Function 

OPLog 

log ( 

OPTenX 

10 A X( 

OPLn 

In ( 

OPEtoX 

e A X ( 

OPNot 

not ( 

OPSin 

sin ( 

OPAsin 

sin-1 ( 

OPCos 

cos ( 

Pacos 

cos-1 ( 

OPTan 

tan ( 

OPAtan 

tan-1 ( 

OPSinh 

sinh ( 

OPAsinh 

sinh-1 ( 

OPCosh 

cosh ( 

OPAcosh 

cosh-1 ( 

OPTanh 

tanh ( 

OPAtanh 

tanh-1 ( 

OPInverse 

recipricol 

OPDet 

det ( 

OPSqroot 

Sqrt 

OPSquare 

A 2 

Opnegate 

(-) 

OPIpart 

iPart ( 

OPFpart 

fPart ( 

OPIntgr 

int ( 

tEvalF 

y# (value 

OPCon j 

conj ( 

OPFact 

1 

OPAbs 

abs ( 

OPIdent 

identity ( 

OPTranspose 

mat transpose OPSum 

sum ( 

OPProd 

prod ( 

OPMin 

min ( 

OPMax 

max ( 

OPTof rac 

>Frac 

OPReal 

real ( 

OPImag 

Imag ( 

OPAngle 

angle ( 

OPExpr 

expr ( 

OPRound2 

round ( 

OPLength 

length ( 

OPCube 

A 3 

OPCbrt 

V 

OPDim 

dim ( 

OPRad 

A r 

OPDeg 

° 

tMean 

mean ( 

tMedian 

median ( 

OP Ref 

ref ( 

OPRref 

rref ( 

OPCumSum 

cumSum ( 

OPNormalPdf 

normalPdf ( 

OPInormal 

invNorm ( 

OPDeltalst 

-List ( 

OPBal 

bal ( 

OPStdev 

stdDev ( 

OPVariance 

variance ( 

OPRand 

rand 




Note: For tEvalF there are really two inputs but execution still goes through the entry point 
for one argument. The Equation name needs to be pushed onto the FPS first, and 
the second argument in OP1 . 


This is valid in all graph modes. 

The second argument is the value to evaluate at. 
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System Routines — 
Screen 


ForceFullScreen 


14-1 
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ForceFullScreen 


Category: Screen 

Description: Switches the TI-83 Plus to Full Screen mode if currently In Plorizontal or 

Vertical split mode. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


None 

None 

None 

None 

None 

None 

All 

Graph is dirtied if mode switched. 
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System Routines — 
Statistics 


DelRes 

OneVar 

Rcl_StatVar 

TwoVarSet.. 


15-1 

1^2 

15^3 

15^4 
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Del Res 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Statistics 

Invalidates the statistic results. 

None 

None 

None 

None 

None 

Statistic result variables marked as undefined. 

RegEq variable is deleted. 

All 

Note that this routine does not set the graphDraw flag even if the stat result 
variable is used in a graph equation. This is a known problem. 

B_CALL DelRes ; invalidate stat results 
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OneVar 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 


Others: 


Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Statistics 

Executes one-variable statistics. 


ACC = number of arguments input 
No_Del_Stat, (IY + more_flags) = 1 if: 

Stat results that are not associated with one-variable stats are not to be 
deleted when this routine executes. 

Also no Min’s, Max’s, or Quartiles will be computed. 

Otherwise: previous statistic results are cleared. 

If ACC = 1 then OP1 = data list name. 

If ACC = 2 then OP1 = frequency list name. 

FPST = data list name. 

Dimensions must match if two arguments. 


None 

statANSDISP, (lY+statFlags) = 1 

If no errors then one-variable stat output variables are updated. 
All 


If the input lists have a formula associated with them this routine will not 
execute it and update the list values. This must be done by the calling 
routine. 

See Find_Parse_Formula. 

Run one-variable stats on data list LI and freq. list L2. 



LD 

HL, Llname 



RST 

rMov9ToOP 1 

; OP1 = LI 


RST 

rPushRealOl 

; data ->FPST 

r 

LD 

HL, L2name 



RST 

rMov9ToOP 1 

; OP1 = L2 

r 

B_CALL 

OneVar 

; execute 1-variable 

r 

RET 



Llname : 

DB 

Li st Ob j , tVarLst , tLl , 0, 0 

L2name : 

DB 

Li st Ob j , tVarLst , tL2 , 0, 0 
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Rcl StatVar 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Statistics 

Recalls a statistic result variable to OP1 . 

ACC = stat variable to recall token value. These are listed in the TI83plus.inc 
file. 

None 

None 

None 

None 

OP1 = stat variable value, floating-point number 
All but the ACC. 

The statistic variables are validated by running a regression or one/two 
variable statistic commands. 

This routine does not check that the statistic variables are valid. Recalling 
one when not valid may result in random values. 

Recall statistic result variable X mean, assume statistic have been 
computed. 

LD A, tXMean ; token value for XMean 

B_CALL Rcl_StatVar ; recall contents to OP1 


TI-83 Plus Developer Guide 


15-3 


Third Release January 25, 2002 


System Routines - Statistics 


TwoVarSet 

Category: Statistics 

Description: Executes two-variable statistics and regressions. 

Inputs: 

Registers: ACC = number of arguments input. Must be at least 2. 

B = type of calculation 

- 0 = LinReg (a+bx) 

1 = ExpReg 

- 2 = LnReg 

- 3 = PwrReg 

- 4 = LinReg (ax+b) 

- 5 = QuadReg 

- 6 = CubicReg 

- 7 = QuartReg 
8 = Med-Med 

- 9 = 2-Var Stats 
19h = LinRegTTest 
1 Ah = Logistic 

- IBh = In use for ANOVA 
ICh = SinReg 

Flags: No_Del_Stat, (IY + more_flags) = 1 if: 

Stat results that are not associated with one-variable stats are not to be 
deleted when this routine executes. 

Also no Min’s, Max’s, or Quartiles will be computed. 

Otherwise: previous statistic results are cleared. 

Others: If ACC = 2 then OP1 = Y - data list name. 

FPST = X - data list name. 

If ACC = 3 then OP1 = frequency list name. 

FPST = Y - data list name. 

FPS1 = X - data list name. 

If ACC = 4 then OP1 = Name of equation to store RegEq to. 

FPST = frequency list name. 

FPS1 = Y - data list name. 

FPS2 = X - data list name 
List dimensions must match. 
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Outputs: 

Registers: None 

Flags: statANSDISP, (lY+statFlags) = 1 

Others: If no errors then stat output variables are updated. Arguments are removed 

from Floating Point Stack. 

Registers All 

destroyed: 

Remarks: This B_CALL is not available on OS version 1.12 or below. The application 

should check the OS version before calling this routine. See GetBaseVer. 

If the input lists have a formula associated with them this routine will not 
execute it and update the list values. This must be done by the calling 
routine. 


See Find_Parse_Formula. 

Example: Calculate LinFteg(ax+b) on x-list LI and y-list L2, and store the results in Y1 . 



LD 

HL, Llname 




RST 

rMov9ToOPl 

t 

OPl = Ll 


RST 

rPushRealOl 

t 

data — >FP ST 

t 

LD 

HL, L2name 




RST 

rMov9ToOPl 

t 

OPl = L2 


RST 

RPushRealOl 

r 

FPS1 = Ll; FPST = 

t 

LD 

HL, Ylname 




RST 

rMov9ToOPl 

r 

OPl = Y1 


LD 

A, 3 

t 

3 arguments 


LD 

B, 4 

t 

calc. LinReg(ax+b) 


B_CALL 

TwoVarSet 

t 

execute stats 

t 

RES 

statANSDISP, ( IY+statFlags ) 

t 

don't show results 


RET 




Llname : 

DB 

Li st Ob j , tVarLst , tLl , 0, 0 



L2name : 

DB 

Li st Ob j , tVarLst , tL2 , 0, 0 



Ylname : 

DB 

EquObj, tVarEqu, tyl, 0, 0 
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System Routines — 
Utility 


Applnit 

AnsName 

Chk_Batt_Low 

ConvDimOO 

CpHLDE 

DisableApd 

EnableApd 

EOP1 NotReal 

Equ_or_NewEqu 

GetBaseVer 

GetSysInfo 

GetTokLen 

Get_Tok_Strng 

lsA2ByteTok 

JForceCmdNoChar 

JForceGraphKey 

JForceGraphNoKey 

MemClear 

MemSet 

Mov7B, Mov8B, Mov9B, MovlOB, Mov18B 

Mov90P10P2 

Mov90P2Cp 

Mov9ToOP1 

Mov9ToOP2 

MovFrOPI 

NZIf83Plus 

OP1 ExOP2, OP1 ExOP3, OP1 ExOP4, OP1 ExOP5, OP1 ExOP6, 
OP2ExOP4, OP2ExOP5, OP2ExOP6, OP5ExOP6 

OP1T0OP2, OP1T0OP3, OP1T0OP4, OP1T0OP5, OPIT0OP6, 
OP2T0OP1, OP2ToOP3, OP2ToOP4, OP2ToOP5, OP2ToOP6, 
OP3T0OP1, OP3T0OP2, OP3ToOP4, OP3ToOP5, OP4ToOP1, 
OP4ToOP2, OP4ToOP3, OP4ToOP5, OP4ToOP6, OP5ToOP1, 



16-1 

16-2 

16-3 


16-4 

16-6 

16-6 


16-7 


16-8 

16-9 


1610 


6-11 


6-13 


6-14 


6-15 


6-16 


6-17 


6-18 


6-19 


6-20 


6-21 


6-22 


6-23 


6-24 


6-25 


6-26 


6-27 


16-28 
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OP 5 T 0 OP 2 , OP 5 T 0 OP 3 , OP5ToOP4, OP5ToOP6, OP 6 T 0 OPI, 
OP 6 T 0 OP 2 , OP6ToOP5 

PosNoOInt 

Put Away 

RclAns 

ReloadAppEntryVecs 

SetExSpeed 

SetXXOPI 

SetXXOP2 

SetXXXXOP2 

StoRand 

StrCopy 

StrLength 


16-29 

16-30 

16-31 

16-33 

16-34 

16-35 

16-37 

16-38 

16-39 

16-40 

16-41 

16-42 
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Applnit 

Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Utility 

Sets system monitor vectors. 

This routine is used by advanced applications to override the system monitor 
vector table. This routine should only be used by applications, not ASM 
programs. 

HL points to monitor vector table. 

None 

None 


None 

None 

OP1 contains the variable name Ans. 
All 


A common use of Applnit is to override the system’s putaway vector. This 
allows the application to save its state or clean up any flags before shutting 
down if the user presses 2 nd + OFF or silent link activity is detected during a 
system B CALL GetKey. 

Monitor vector table format: 


DW 

CXMainPtr 

DW 

CXPPutAwayPtr 

DW 

CXPutAwayPtr 

DW 

CXRedispPtr 

DW 

CXErrorEPPtr 

DW 

CXSizeWindPtr 

DB 

AppFlagsByte 


The application must set all of these pointers to a label somewhere in the 
application. If a vector is not used, it must point to a RET statement. 

If an application uses Applnit to change the system monitor vectors, it must 
perform a B_CALL ReloadAppEntryVecs before exiting and also in the 
application’s putaway routine. 

See also ReloadAppEntryVecs. 

See Chapter 2: “Entering and Exiting an Application Properly” for example 
putaway code. 
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AnsName 


Category: 

Utility 

Description: 

Inputs: 

Loads OP1 with the variable name Ans. 

Registers: 

None 

Flags: 

None 

Others: 

None 

Outputs: 

Registers: 

None 

Flags: 

None 

Others: 

OP1 contains the variable name Ans. 


Registers All 
destroyed: 

Remarks: 

Example: B_CALL AnsName ; load 0P1 with Ans variable 
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Chk Batt Low 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


1 if battery is low. 


Utility 

Check for low battery. Return Z 

None 

None 

None 

Z = 1 if battery is low. 

Z = 0 if battery is not low. 

None 

None 

All 


An application should check the battery condition before attempting to 
archive a variable. There is a risk of corrupting the archive if the attempt 
fails due to low batteries. 


Example: 


Archive variable whose name is in OP1 if batteries are not low: 


errorHand : 


B_CALL 

Chk_Batt_Low 

; check battery level 

RET 

Z 

; ret if low batteries 

B_CALL 

ChkFindSym 


RET 

C 

; return if variable does not exist 

LD 

A, B 

; get archived status 

OR 

A 

; if non zero then it is archived 



; already 

RET 

NZ 

; ret if archived 

AppOnErr 

errorHand 

; install error handler 

B_CALL 

Arc_Unarc 

; archives the variable 

AppOf f Err 


; remove error handler 

RET 
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ConvDimOO 


Category: 

Description: 

Inputs: 

Utility 

Converts floating-point number in OP1 to a two-byte value and compares 
that value with an input two-byte value. 


Registers: 

HL = two-byte test value 

Flags: 

None 

Others: 

OP1 = floating-point value, must be a positive integer < 10,000 


Outputs: 

Registers: If no error on the input: 

A = LSB hex value of OP1 



DE = entire hex value of OP1 

Flags: 

None 

Others: 

None 

Registers 

destroyed: 

Remarks: 

All 

Example: 

Test OP1 = positive integer < or = 400: 


LD HL,400d ; test value 

B_CALL ConvDimOO 
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CpHLDE 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Utility 

Non destructives compare of registers HL and DE. 

HL = two-byte value 
DE = two-byte value 

None 

None 


HL, DE intact 

CA = 1 if DE > HL 
Z= 1 if HL= DE 
CA = 0 if HL > DE 

None 

None 


B_CALL CpHLDE 
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DisableApd 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Utility 

Turns off Auto Power Down feature. 

None 

None 

None 

None 

None 

apdAble, (IY + apdFlags) is reset 
None 

Applications should re-enable APD before exiting. See EnableApd. 
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EnableApd 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Utility 

Turns on Auto Power Down. 

None 

None 

None 

None 

None 

None 

None 

The TI-83 Plus will now power down if not used for approximately 
four minutes. 


Example: 
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EOPINotReal 


Category: Utility 

Description: Tests object in OP1 to be a real data type. If it is not, then jump to the 

system error DATA TYPE. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


None 

None 

(OP1) = objects data type byte 

None 

None 

Error if not OP1 — it does not have the data type RealObj. 
A 
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Equ_or_NewEqu 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Utility 
Sees if A 


EquObj or NewEquObj type. 


A = type, can have flags set 

None 

None 

A = type with flags reset 

Z set if A = EquObj or NewEquObj type 

None 

None 


; see if ACC is EquObj or NewEquObj 
Equ_or_NewEqu : : 


AND 

lFh 

CP 

EquObj 

RET 

Z 

CP 

NewEquObj 

RET 
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GetBaseVer 


Category: Utility 

Description: Returns current operating system version number. 

Inputs: 

Registers: None 


Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


None 

None 

A = major version number 
B = minor version number 

None 

None 

A, B 


For Operating system 1 .00: A = 1 , B = 0. 
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GetSysInfo 


Category: Utility 

Description: Return nine bytes of system information, including current speed. 

Inputs: 

Registers: HL = RAM location to save system information. 

Flags: None 

Others: None 

Outputs: 

Registers: None 


Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 


None 

(HL)...(HL+8) contain system information. 
All 


This B_CALL is not available on TI-83 Plus version 1.12 and earlier. The 
calling routine needs to check the software version before performing this 

B CALL. See GetBaseVer. 

This routine returns nine bytes of data representing various aspects of 
system operation: 


Btye 


00 

Boot code revision # (Major) 

01 

Boot code revision # (Minor) 

02 

Hardware revision # (00 is TI-83 Plus, NZ if not) 

03 

Lsn = Current Speed 

03 

Bit 4 reset if TI-83 Plus; set it TI-83 Plus Silver Edition 

04 

Device code default 

05 

Reserved 

06 

Reserved 

07 

Reserved 

08 

Reserved 


(continued) 


Example: 


Determine if running fast or slow. 
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MustBeSlow : 


Abovell2 : 


Done : 


B_CALL 

GetBaseVer 

; OS version in A, B 

CP 

2 

; check major version 

JR 

NC, abovell2 

; if 2.x, then > 1.12 

CP 

1 


JR 

NZ, MustBeSlow 

; if 0.x, then < 1.12 

LD 

A, B 

; major version = 1 

CP 

13 

; check minor version 

JR 

NC, abovell2 

; C if minor version 

XOR 

A 

; set Z to show slow 

JR 

Done 

; later than 1 . 12 

LD 

HL, OP1 


B_CALL 

GetSysInfo 


LD 

A, OP1+3 


AND 

OFh 



13 
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GetTokLen 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Utility 

Return the number of characters in a token’s string. 

DE = pointer to either a one or two byte token 

None 

None 

A = number of characters in the token’s string 
HL = address of string in Flash ROM. 

None 

None 

All 


Find the number of characters in the ‘Sin(‘ token string. 


LD DE, tSin 

B_CALL GetTokLen 


Sin ( token 

ACC = 4, the length of 'Sin(' 
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Get_Tok_Strng 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 


Flags: 

Others: 

Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


Utility 

Copy a token’s string to OP3 and return the number of characters in the 
string. 

HL = pointer to either a one or two byte token 

None 

None 

A = number of characters in the token’s string 

BC = also contains the number of characters in the token’s string 

HL = address of OP3, location the string was copied to 

None 

String copied to RAM, starting at OP3 
All 

OP3 - OP3 + (length of string) 

Find the number of characters in the ‘Sin(‘ token string. 


LD 

A, tSin 

; Sin ( token 

LD 

(OP1) ,A 


LD 

HL, OP1 

; pointer to token 

B_CALL 

Get_Tok_Strng 

r 
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lsA2ByteTok 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Utility 

Determines if token in A is a one or two byte token. 

A = First byte of token 

None 

None 

None 

Z = 1 if A is the first byte of a two byte token 
Z = 0 if A is not a two byte token. 

None 

None 

The two byte token identifiers are: t2ByteTok, tVarStrng, tGFormat, tVarSys, 
tVarOut, tVarGBD, tVarPict, tVarEqu, tVarLst, and tVarMat. 


Example: 
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JForceCmdNoChar 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Utility 

Exits the Application and returns to the home screen. 

This should not be used to exit an application if the TI-83 Plus system 
monitor is closing the application due to link activity or turning off. 

This routine will be the used in most applications to Close the application 
and return control to the TI-83 Plus system. 

Before an application jumps to this entry point it must make certain the 
systems monitor vectors are set to the Application loader context. 

See Entering and Exiting an Application Properly. 


None 

None 

Monitor vectors should be set to the Application loader. 


None 

None 

The home screen is given control. 
All 


Only use a B_JUMP with this entry point. 

This can be used by an application anytime — the return stack does not 
need to be at any certain level. This routine will set the stack level back to a 
safe level. 

ASM PROGRAMS SHOULD NOT USE THIS ROUTINE TO EXIT BACK TO 
THE SYSTEM. 

Set the monitor vectors to the Application loader and exit the application and 
return control to the home screen. 

Exit_App : 

B_CALL 


B JUMP 


ReloadAppEntryVecs 


load the monitor vectors 
to App loader 


JForceCmdNoChar 


exit the app and 
initiate home screen 
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JForceGraphKey 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Utility 

Exits the Application and returns to the graph screen with a key to be 
executed in the graph screen. 

This should not be used to exit an application if the TI-83 Plus system 
monitor is closing the application due to link activity or turning off. 

This routine will be the used in most applications to Close the application 
and return control to the TI-83 Plus system. 

Before an application jumps to this entry point it must make certain the 
systems monitor vectors are set to the Application loader context. 

See Entering and Exiting an Application Properly. 

ACC = key to execute in the graph screen 

None 

None 


None 

None 

None 

All 


Only use a B_JUMP with this entry point. 

This can be use by an application anytime — the return stack does not need 
to be at any certain level. This routine will set the stack level back to a safe 
level. 

ASM PROGRAMS SHOULD NOT USE THIS ROUTINE TO EXIT BACK TO 
THE SYSTEM. 

Set the monitor vectors to the Application loader and exit the application and 
enter trace mode. 

Exit_App : 


B_CALL 

ReloadAppEntryVecs 

; load the monitor vectors 
; to App loader 

LD 

A, kTrace 


B JUMP 

JForceGraphKey 

; exit the app enter trace 
; mode 
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JForceGraphNoKey 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Utility 

Exits the Application and returns to the graph screen. 

This should not be used to exit an application if the TI-83 Plus system 
monitor is closing the application due to link activity or turning oft. 

This routine will be the used in most applications to close the application and 
return control to the TI-83 Plus system. 

Before an application jumps to this entry point it must make certain the 
systems monitor vectors are set to the Application loader context. 

See Entering and Exiting an Application Properly. 


None 

None 

None 


None 

None 

None 

All 


Only use a B_JUMP with this entry point. 

This can be use by an application anytime — the return stack does not need 
to be at any certain level. This routine will set the stack level back to a safe 
level. 

ASM PROGRAMS SHOULD NOT USE THIS ROUTINE TO EXIT BACK TO 
THE SYSTEM. 

Set the monitor vectors to the Application loader and exit the application and 
give control to the graph context. 

Exit_App : 


B_CALL 

ReloadAppEntryVecs 

; load the monitor vectors 
; to App loader 

LD 

B JUMP 

A, kTrace 
JForceGraphNoKey 

; exit the app 


TI-83 Plus Developer Guide 


16-18 


Third Release January 25, 2002 


System Routines - Utility 


MemClear 


Category: 

Description: 

Input: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Utility 

Clears a memory block (to OOh’s). 

BC = number of bytes in block 

HL = address of first byte in memory block 

None 

None 

None 

None 

Memory block cleared 
A, BC, DE, HL 

BC must be > 1 
TBD 
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MemSet 

Category: 

Description: 

Inputs: 

Registers: 


Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Utility 

Sets a memory block to a given value. 

A = value to set all bytes in memory block 

BC = number of bytes in block 

HL = address of first byte in memory block 

None 

None 

None 

None 

Memory block set 
BC, DE, HL 

BC must be > 1 
TBD 
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Mov7B, Mov8B, Mov9B, MovlOB, Mov18B 


Category: 

Description: 


Utility 

Copies a short memory block where X = MovXB, where X is the number of 
bytes. 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


HL = start of source block 
DE = start of destination block 

None 

None 

None 

None 

Block starting at original HL copied to area starting at original DE. 
BC, DE, HL 


Remarks: 

Example: 
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Mov90P10P2 


Category: 

Description: 


Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Utility 

Copies a block of 18 bytes of RAM/ROM to OP1/OP2, with the first nine- 
bytes to OP1 and the second nine-bytes to OP2. 

This is most commonly used to copy a complex element of either a list or 
matrix to OP1 /OP2, skipping the 1 0th and 1 1 th bytes of OP1 . 


HL = pointer to start of 18 bytes to copy 

None 

None 


DE = DE + 18 
None 

First nine-bytes OP1 and first nine-bytes of OP2 contain the 18 bytes 
copied. 

All but ACC 


Copy the first element of complex list LI to OP1/OP2: 


LD 

HL, Llname 


RST 

rMov9ToOPl 

; OP1 = LI name 

B_CALL 

FindSym 

; look up, DE = pointer to data 

EX 

DE, HL 

; HL = pointer to data 

INC 

HL 


INC 

HL 

; HL = pointer to 1st element 

B_CALL 

Mov90P10P2 

; OP1 = real part, OP2 = image 
; part, of element 1 

RET 
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Mov90P2Cp 

Utility 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


Copies a floating-point number from RAM/ROM to OP2 and compares it to a 
floating-point number in OP1. 


HL = pointer to floating point to copy to OP2 
None 

OP1 = floating-point number 

None 

Z = 1 if OP1 = OP2 
Z = 0, CA=1:OP1 < OP2 
Z = 0, CA = 0:OP1 OP2 

OP1 = intact 

OP2 = floating-point number copied 
All 


Both OP1 and the float copied to OP2 are preserved. 

Copy the first element of real list LI to OP2 and compare it to a floating- 
point number in OP1 . 


LD 

HL, Llname 





RST 

rMov9ToOPl 

; OP1 = 

= LI name 


B_CALL 

FindSym 

; look 

up, DE = 

: pointer to data 

EX 

DE, HL 

; HL = 

pointer 

to 

data 

INC 

HL 





INC 

HL 

; HL = 

pointer 

to 

1st element 

B_CALL 

Mov90P2Cp 

; copy 

element 

to 

OP2 and 



; compare to OP1 


RET 
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Mov9ToOP1 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


Utility 

Copies nine-bytes of RAM/ROM to OP1 . 

HL = pointer to the nine-bytes to copy 

None 

None 

None 

None 

OP1 contains the nine-bytes 
All but ACC 


Remarks: 

Example: b_call mov9toopi 
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Mov9ToOP2 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


Utility 

Copies nine-bytes of RAM/ROM to OP2. 

HL = pointer to the nine-bytes to copy 

None 

None 

None 

None 

OP2 contains the nine-bytes 
All but ACC 


Remarks: 

Example: b_call mov9toop2 
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MovFrOPI 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 


Utility 

Copies OP1 (nine bytes) to another RAM location. 

DE = pointer to destination of move 

None 

None 

None 

None 

HL = OP1 +9 
DE = DE + 9 
OP1 copied to (DE) 


Registers All but ACC 
destroyed: 


Remarks: 

Example: 
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NZIf83Plus 


Category: Utility 

Description: Returns status if calculator is TI-83 Plus or not. 

Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 


Flags: 


Others: 

Registers 

destroyed: 


NZ = status if TI-83 Plus 

Z = status if TI-83 Plus Silver Edition 

None 

None 


Remarks: 


Example: 


This B CALL is not available on TI-83 Plus version 1 .1 2 or earlier. The 
calling routine must check the software version before performing this 
B_CALL. This routine is not as intrusive as GetSysinfo if all you need to 
know is it the calculator is an earlier edition of TI-83 Plus. 


See GetBaseVer, GetSysinfo 

Return NZ if running on TI-83 Plus 


MustBe83Plus : 


Abovell2 : 


B_CALL 

GetBaseVer 

CP 

1 

JR 

C, MustBe83Plu 

JR 

NZ, Abovell2 

LD 

A, B 

CP 

13 

JR 

NC, abovell2 


RET 


B_CALL 

NZIf83Plus 


RET 


; OS version in A, B 
; check major version 
; if 0.x, then < 1.13 
; if 2.x, then > 1.12 
; major version = 1 
; check minor version 
; C if minor version < 


; later than 1 . 12 


13 
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OP1 ExOP2, OP1 ExOP3, OP1ExOP4, OP1 ExOP5, 
OP1EXOP6, OP2EXOP4, OP2ExOP5, OP2ExOP6, 
OP5ExOP6 


Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Utility 

Exchanges 1 1 -byte contents of OP(x) with OP(y). 

None 

None 

None 


None 

None 

OP(X) = former contents of OP(Y) 
OP(Y) = former contents of OP(X) 

A, BC, DE, HL 


Combinations Available: 

(y) OP1 OP2 OP3 OP4 OP5 OP6 

(x) 

OP1 X X X X X 

OP2 XXX 

OP3 
OP4 

OP5 X 

OP6 

; Exchange contents of OP2 and OP4 
B CALL OP2ExOP4 
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OP1TOOP2, OP1TOOP3, OP1TOOP4, OP1ToOP5, 
OPIT0OP6, OP2ToOP1, OP2ToOP3, OP2ToOP4, 
OP2ToOP5, OP2ToOP6, OP3ToOP1, OP3ToOP2, 
OP3ToOP4, OP3ToOP5, OP4ToOP1, OP4ToOP2, 
OP4ToOP3, OP4ToOP5, OP4ToOP6, OP5ToOP1, 
OP5ToOP2, OP5ToOP3, OP5ToOP4, OP5ToOP6, 
OP6T0OPI, OP6ToOP2, OP6ToOP5 


Category: Utility 

Description: Copies 1 1 bytes from OP(x) to OP(y). 

Inputs: 

Registers: None 
Flags: None 

Others: OP(x) 

Outputs: 

Registers: None 


Flags: 

Others: 

Registers 

destroyed: 


None 

OP(y) = former contents of OP(x) 
BC, DE, HL 


Remarks: 


Example: 


Combinations Available: 

Dest(y) OP1 OP2 OP3 OP4 OP5 OP6 

Source(x) 

OP1 X X X X X 

OP2 X X X X X 

OP3 XX XX 

OP4 XXX XX 

OP5 X X X X X 

OP6 XX X 

B_CALL OPlToOP3 
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PosNoOInt 

Category: Utility 

Description: Checks if OP1 is a positive non-zero integer floating point. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point number 

Outputs: 

Registers: None 

Flags: Z = 1 if OP1 = positive non 0 integer 


Others: 

Z = 0 if non integer or negative or 0 

None 

Registers 

destroyed: 

Remarks: 

Example: 

ACC 
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PutAway 


Category: 

Utility 

Description: 

Force application to be put away. 

Inputs: 


Registers: 

None 

Flags: 

None 

Others: 

None 

Outputs: 


Registers: 

None 

Flags: 

None 

Others: 

Application is terminated. 

Registers 

destroyed: 

ALL 

Remarks: 

Applications should not use this routine for normal exit code. Applications 
should only use this entry point as part of putaway code in “Stand-Alone with 

Putaway Notification” mode. See Chapter 2: “Entering and Exiting an 
Application Properly”. 

Example: 

AppPutAway : 

r 

r 

; Application gets itself ready for terminating by cleaning any system flags 
; or saving any information it needs to. 

r 

RES plotLoc, ( IY+plotFlags ) ; draw to display & buffe 

RES textWrite, ( IY+sGrFlags ) ; small font written to 

; display 

; This next call resets the monitor control vectors back to the App Loader 

r 

B_CALL ReloadAppEntryVecs ; App Loader in control o 

; monitor 

r 

LD ( IY+textFlags ) , 0 ; reset text flags 

r 

; This next call is done only if application used the Graph Backup Buffer 

r 

B_CALL SetTblGraphDraw 

t 

; Need to check if turning off or not, the following flag is set when 
; turning off: 

t 

BIT MonAbandon, ( IY+monFlags ) ; turning off ? 

JR NZ, TurningOff ; jump if yes 

t 

; if not turning off then force control back to the home screen 

; note: this will terminate the link activity that caused the application 
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; to be terminated 


LD 

OUT 

B_CALL 

SET 

El 

A, iall ; all interrupts on 

( intrptEnPort ) , A 

LCD_DRIVERON ; turn on LCD 

onRunning, (IY+onFlags) ; on interrupt running 

; enable interrupts 

B JUMP 

JForceCmdNoChar ; force to home screen 

t 

TurningOf f : 

B JUMP 

Putaway ; force App loader to do its 

; put away 
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RclAns 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

Remarks: 


Example: 


Utility 

Recalls answer to OP1[,OP2] or at least set up pointers to it. 

None 

None 

None 


None 

None 

OP1[,OP2] if real [or complex] 
AF, BC, DE, HL, 


Entire code: 


CALL AnsName 

JP RclVarSym 


AnsName puts the name of Ans into 

OP1 = 00h,tAns,00h,00h, OOh 

= 00h,072h,00h,00h, OOh 


see these routines for more 
info 

see these routines for more 
info 


RclVarSym will recall the contents of the variable to OP1 if it is real, to OP1 
and OP2 if the variable is complex and otherwise leaves the name as is in 
OP1 and returns HL as the symbol table pointer and DE as the data pointer 

as in ChkFindSym. 


B_CALL 

RclAns 

; This example presumes that 
; you already know that Ans is 
; a Real number. 

LD 

A, 9 

; display up to 8 digits 

B_CALL 

DispOPlA 

t 
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ReloadAppEntryVecs 


Category: Utility 

Description: Sets the system monitor vector table to the Application loader context. 

This routine is used by advanced applications that override the system 
monitor vector table. This routine should be called by the application just 
before exiting. 

This routine should only be used by applications, not ASM programs. 


Inputs: 

Registers: None 
Flags: None 

Others: None 

Outputs: 

Registers: None 


Flags: 

Others: 

Registers 

destroyed: 

Remarks: 

Example: 


None 

Monitor system vectors are now set to the application loader. 
All 


Assume we have an application that overrode the monitor vectors and our 
application is exiting because the user pressed the [Quit] key. 


ChkForQuit : 

CP 

kQuit 

; quit key? 


JR 

NZ , notQuit 

; jump if no 

r 

B_CALL 

ReloadAppEntryVecs 

; restore monitor to 


B JUMP 

JForceCmdNoChar 

; application loader 
; switch to the home 




; screen 
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SetExSpeed 


Category: 

Description: 

Inputs: 

Registers: 


Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 


Utility 

Set execution speed to fast or slow. 

A = 0 to set slow speed (6Mhz) 

A = 1 to set 15Mhz 

A = FF to set fastest future speed 

None 

None 

None 

None 

None 

Flag register modified 


Remarks: This B CALL is not available on TI-83 Plus version 1 .1 2 or earlier. The 

calling routine must check the software version before performing this 
B_CALL. This routine is not as intrusive as GetSysinfo if all you need to 
know is if the calculator is an earlier edition of TI-83 Plus. 

See GetBaseVer, GetSysinfo 

This routine can be called on a TI-83 Plus unit running software version 1 .13 
and higher, but will not effect the operating speed of that unit. 

On the TI-83 Plus Silver Edition, the operating system will set the speed 
back to fast once the application or assembly program returns, regardless of 
any settings changed. An exception to this is that the error handler will 
leave the speed setting intact in the event a GoTo is desired. 

Some system routines such as the 10 utilities may set slow speed for certain 
operations. These routines will restore the current speed upon completion. 
Other routines, such as JforceCmdNoChar force fast speed. Normally an 
application will not execute these routines except on completion. 

(continued) 
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Example: 


Set fast speed if running on 1.13 or higher. 


B_CALL 

GetBaseVer 

CP 

2 

JR 

NC, Abovell2 

CP 

1 

JR 

NZ, Belowll2 

LD 

A, B 

CP 

13 

JR 

C, Belowll2 


Abovell2 : 


LD 

A, OFFh 

B_CALL 

SetExSpeed 

JR 

Done 


Belowll2 : 


Done : 


; OS version in A, B 
; check major version 
; if 2.x, then > 1.12 
; if 0.x, then < 1.12 
; major version = 1 

t 

; check minor version 
; C if minor version < 13 


; set fastest speed possible 

; earlier than 1.12 
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SetXXOPI 

Category: Utility 

Description: Sets OP1 equal to a floating-point integer between 0 and 99 

Inputs: 

Registers: ACC = integer value to set OP1 equal to 
Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 


Others: 

Registers 

destroyed: 

OP1 = floating-point integer between 0-99 

All 

RAM used: 

OP1 

Remarks: 

Example: 

No error checking is done for invalid input. 

Set OP1 = 75. 


LD A, 75 

B_CALL SetXXOPI ; OP1 = floating point 75 
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SetXXOP2 

Category: Utility 

Description: Sets OP2 equal to a floating-point integer between 0 and 99 

Inputs: 

Registers: ACC = integer value to set OP2 equal to 
Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 


Others: 

Registers 

destroyed: 

OP2 = floating-point integer between 0-99 

All 

RAM used: 

OP2 

Remarks: 

Example: 

No error checking is done for invalid input. 

Set OP2 = 75. 


LD A, 75 

B_CALL SetXXOP2 ; OP2 = floating point 75 
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SetXXXXOP2 


Category: Utility 

Description: Sets OP2 equal to a floating-point integer between 0 and 65535. 

Inputs: 

Registers: HL = integer value to set OP2 equal to 
Flags: None 

Others: None 

Outputs: 

Registers: None 


Flags: 


None 


Others: OP2 = floating-point integer between 0 - 65535 


Registers 

destroyed: 

RAM used: 

Remarks: 

Example: 


All 

OP2 

Set OP2 = 7523. 


LD HL, 7523 

B_CALL SetXXXXOP2 ; OP2 = floating point 7523 
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StoRand 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

destroyed: 

RAM used: 
Remarks: 


Example: 


Utility 

Initializes random number seeds on OP1 value. 

None 

None 

OP1 = real number OeO ... < 1 E9 


None 

None 

OP1 = same value as unmodified input. 

All 

OP1, OP2, OP6 

Storing a 0 to the seed will reinitialize the random number generator to its 
original state from the factory. 

The input value in OP1 must be a real number, but it does not have to fall 
within the specified range. If it does not, it will be modified (exponent 
reduced, sign changed, and truncated) to fit in the range. 
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StrCopy 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 

Destroyed: 

Remarks: 


Example: 


Utility 

Copy a null-terminated string in memory. 

HL = starting address of source string 
DE = starting address of destination 
None 
None 

None 
None 
None 
A, DE, HL 

This is like a C language StrCpyQ function. 

When complete: 

? HL is left pointing to the null terminator of the source string. 

? DE is left pointing to the null terminator of the destination string. 
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StrLength 

Category: Utility 

Description: Returns the length of a zero (0) terminated string residing in RAM. 

Inputs: 

Registers: HL = pointer to start of zero terminated string, in RAM 
Flags: None 

Others: None 

Outputs: 

Registers: BC = length of string, not including terminating 0 

Flags: None 

Others: None 

Registers BC 

destroyed: 

Remarks: 

Example: 
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System Routines — 
Miscellaneous 


ConvOPI 


17-1 
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ConvOPI 


Category: Miscellaneous 

Description: Converts a floating-point number in OP1 to a two-byte hexadecimal number 

in DE. 


Inputs: 

Registers: OP1 = floating-point number 

Flags: None 

Others: None 

Outputs: 

Registers: A = LSB hex value 

DE = entire hex value 
If OP1 exponent > 3 error 

Flags: None 

Others: None 

Registers 

destroyed: 

Remarks: 

Example: 
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Reference List — 
System Routines 


Abs0102Cp 

AbsOI PAbs02 . 

ACos 

ACosH 

ACosRad 


10-1 


10-2 


10-3 


10-4 


10-5 


AdrLEIe 9-1 


See Math 
See Math 
See Math 
See Math 
See Math 
See List 


AdrMEIe |1 1-1 J See Matrix 

AdrMRow |l 1-2,| See Matrix 

AIIEq |5-1 J See Graphing and Drawing 

AllocFPS 4-1 J See Floating Point Stack 

AllocFPSI 4-2, See Floating Point Stack 

Angle |l0-6l See Math 

AnsName |l6-2] See Utility 

ApdSetup [8-1 1 See Keyboard 

AppGetCalc |7-l[ See 10 

AppGetCbl J7-2J See 10 

Applnit 16-1 


Arc_Unarc 12-1 

ASin 


10-7 


See Utility 
See Memory 
See Math 


10-10 See Math 


ASinFI |10-8j See Math 

ASinRad |10-9,| See Math 

ATan 

ATan2 

ATan 2 Rad 

ATan FI 

ATan Rad 


10-11 See Math 


10-12 See Math 


10-13 See Math 


10-14 See Math 


BinOPExec. 

Bit_VertSplit 

BufClr 

BufCpy 


B 


5-2 

543 


Il3-ll See Parser 

|l-1 1 See Display 

See Graphing and Drawing 
See Graphing and Drawing 
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CAbs 10-15 See Math 


CAdd 10-16 See Math 


CanAlphlns |8-2] See Keyboard 

CDiv |l 0-1 7| See Math 

CDivByReal 


10-18 


See Math 


CEtoX 10-19 See Math 


CFrac 1 0-20 See Math 


CheckSplitFlag |1-2j See Display 

ChkFindSym |l2-2j See Memory 

Clntgr |10-21 j See Math 

CircCmd |5-4] See Graphing and Drawing 

Cklnt 

CkOdd 

CkOPICO 

CkOPICpIx 

CkOPlFPO 

CkOPIPos 

CkOPI Real 

CkOP2FPO 

CkOP2Pos 

CkOP2Real 


See Math 
See Math 
See Math 
See Math 
See Math 
See Math 
See Math 
See Math 
See Math 
See Math 
See Math 
See Math 

CleanAII |12-4J See Memory 

ClearRect |5-6| See Graphing and Drawing 

ClearRow |l-3j See Display 

CLine 

CLineS 


CkPosInt 10-32 


CkValidNum 10-33 


10-22, 

10-23 

10-24 

10-25 

10-26 

10-27 

10-28 

10-29 

10-30 

10-31 

10-32 

10-33 


5-7 


5-9 


See Graphing and Drawing 
See Graphing and Drawing 

CLN |l 0-341 See Math 

CLog |l0-35j See Math 

CloseEditBuf |2-l| See Edit 

CloseEditBufNoR |2-2l See Edit 


CloseEditEqu |2-3| See Edit 

CloseProg |12-5| See Memory 

ClrGraphRef |5-1 1| , See Graphing and Drawing 

ClrLCD 


1-4 


See Display 

ClrLCDFull |1-5| See Display 

ClrLp 10-36| See Math 
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ClrOPIS |1 0-37,1 See Math 

ClrOP2S See Display 

ClrScrn |l-7| See Display 

ClrScrnFull |l-8| See Display 

ClrTxtShd 1-9, See Display 

CMItByReal 10-38 See Math 

CmpSyms |l2-6] See Memory 

CMult 10-39, See Math 

Conj 10-40, See Math 

ConvDim 9-2| See List 


ConvDimOO |16-3j See Utility 

ConvLcToLr 9-3l See List 

ConvLrToLc SF4 See List 

ConvOPI |l 7-1 ] See Miscellaneous 

COPISetO 1 1 0-41 L See Math 


Cos 10-42, See Math 


CosH 1 0-43 , See Math 


CpHLDE 16-5] See Utility 

CPoint 


5-12 


See Graphing and Drawing 
CPointS |5-14j See Graphing and Drawing 


Cp0P10P2 

Cp0P40P3 

CpyOIToFPSI 

Cpy01ToFPS2 

Cpy01ToFPS3 

Cpy01ToFPS4 

Cpy01ToFPS5 

Cpy01ToFPS6 

Cpy01ToFPS7 

CpyOIToFPST 

Cpy02ToFPS1 

Cpy02ToFPS2 

Cpy02ToFPS3 

Cpy02ToFPS4 

Cpy02ToFPST 

Cpy03ToFPS1 

Cpy03ToFPS2 

Cpy03ToFPST 

Cpy05ToFPS1 

Cpy05ToFPS3 


4-4 

4-4 

4-4 

4-4 

4-4 

4-4 

4-4 

4-4 

4-4 

4-4 

4-4 

4-4 

4-4 

4-4 

4-4 

4-4 

4-4 

4-4 


See 

See 

See 

See 

See 

See 

See 

See 

See 

See 

See 

See 

See 

See 

See 

See 

See 

See 


1 0-44] See Math 

10-45] See Math 

Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
Floating Point Stack 
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Cpy06ToFPS2 

Cpy06ToFPST 

CpyStack 

CpyTol FPS1 ... 
CpyTolFPSIO. 
CpyTol FPS1 1 . 
CpyTol FPS2... 
CpyTol FPS3... 
CpyTol FPS4... 
CpyTol FPS5... 
CpyTol FPS6... 
CpyTol FPS7... 
CpyTol FPS8... 
CpyTol FPS9... 
CpyTol FPST... 
CpyTo2FPS1 ... 
CpyTo2FPS2... 
CpyTo2FPS3... 
CpyTo2FPS4... 
CpyTo2FPS5... 
CpyTo2FPS6... 
CpyTo2FPS7... 
CpyTo2FPS8... 
CpyTo2FPST... 
CpyTo3FPS1 ... 
CpyTo3FPS2... 
CpyTo3FPST... 
CpyTo4FPST... 
CpyTo5FPST... 
CpyTo6FPS2... 
CpyTo6FPS3... 
CpyTo6FPST... 

CpyToFPSI 

CpyToFPS2 

CpyToFPS3 

CpyToFPST 

CpyToStack 

CreateOEqu 

CreateAppVar.. 
CreateCList 


4-4 

4-4 


4-3 


4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 

4-5 


4-7 


4-8 


4-9 


4-6 


4-10 


See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
1 12-71 See Memory 


12-8j See Memory 


12-9| See Memory 
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CreateCpIx 

CreateEqu 

CreatePair 

CreatePict 

Create Prog 

CreateProtProg 

CreateReal 

CreateRList 

CreateRMat 

CreateStrng 

CRecip 

CSqRoot 

CSquare 

CSub 

CTenX 

CTrunc 

Cube 

CursorOff 

CursorOn 

CXrootY 

CYtoX 

DarkLine 

DarkPnt 

DataSize 

DataSizeA 

DeallocFPS 

DeallocFPSI .... 

DecOI Exp 

DelListEI 

DelMem 

DelRes 

DelVar 

DelVarArc 

DelVarNoArc ... 

DisableApd 

Disp 

DispDone 

DispEOL 


12-10 


12-11 


12-12 


12-13 


12-14 


12-15 


12-16 


12-17 


12-18 


12-19 


See Memory 
See Memory 
See Memory 
See Memory 
See Memory 
See Memory 
See Memory 
See Memory 
See Memory 
See Memory 


10-46, See Math 


10-47, See Math 


10-48, See Math 


10-49 See Math 


10-50 See Math 


10-51 See Math 


10-52 See Math 


2-4 See Edit 


2-5 See Edit 


10-53 See Math 


10-54 See Math 


5-16 


12-20 


See Graphing and Drawing 
5-18[ See Graphing and Drawing 
See Memory 
See Memory 
See Memory 
See Memory 


12-21 


12-22 


12-23 


10-55, See Math 


9-5 See List 


12-24| See Memory 
, |15-1 1 See Statistics 
See Memory 
See Memory 
See Memory 


12-26 


12-27 


12-28 


16-6, See Utility 


5-20 See Graphing and Drawing 


1-10| See Display 


2-6J See Edit 
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DispHL |1-1 1 1 See Display 

Displaylmage |l-12| See Display 

DispOPIA |l-14| See Display 

DivHLBylO 6-1 See Interrupt 


DivHLByA |6-2| See Interrupt 


DrawCirc2 |5-21 See Graphing and Drawing 


DrawCmd 5-23 See Graphing and Drawing 


DrawRectBorder 5-24 See Graphing and Drawing 


DrawRectBorderClear 5-25 See Graphing and Drawing 


DToR 10-56, See Math 


EditProg |12-29| See Memory 


EnableApd 16-7, See Utility 


EnoughMem |12-30[ See Memory 


EOP1 NotReal |16-8] See Utility 

Equ_or_NewEqu |l6-9] See Utility 


EraseEOL |1-15| See Display 


EraseRectBorder |5-26| See Graphing and Drawing 

ErrArgument |3-l[ See Error 

ErrBadGuess |3-2[ See Error 


ErrBreak |3-3[ See Error 

ErrD OP1 0 13-41 See Error 


ErrD OP1 LE 0 3-5 See Error 


ErrD OPINot R 3-6 See Error 


ErrD OP1 NotPos 3-7 See Error 


ErrD OPINotPosInt 3-8 See Error 


ErrDataType J3-91 See Error 

ErrDimension j3-10| See Error 

ErrDimMismatch ]3-1 1 1 See Error 

ErrDivByO J3-12| See Error 

ErrDomain j3-13| See Error 

Errlncrement ]3-14| See Error 

Errlnvalid ]3-15| See Error 


Errlterations ]3-16| See Error 

ErrLinkXmit J3-17| See Error 

ErrMemory J3-18| See Error 

ErrNon Real |3-19j See Error 

ErrNonReal J3-20| See Error 

ErrNotEnoughMem |3-21 See Error 
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ErrOverflow 

ErrSignChange 

ErrSingularMat. 

ErrStat 

ErrStatPlot 

ErrSyntax 

ErrTolTooSmall 
ErrUndefined ... 

EToX 

Exch9 

ExLp 

ExpToHex 


3-22 See Error 


3-23 See Error 


3-24, See Error 


3-25 See Error 


3-26 See Error 


3-27 See Error 


3-28, See Error 


3-29 See Error 


10-57 See Math 


12-31j See Memory 


12-32 See Memory 


10-58, See Math 


Factorial 10-59 See Math 


FillRect |5-27| See Graphing and Drawing 

FillRectPattern |5-29| See Graphing and Drawing 

Find Parse Formula |9-6| See List 


FindAlphaDn 

FindAlphaUp 

FindApp 

FindAppDn 

FindAppNumPages 

FindAppUp 

FindSym 


12-33| See Memory 
12-35 See Memory 
12-37 See Memory 
12-39] See Memory 
See Memory 
See Memory 
See Memory 


12-38, 


12-40, 


12-41 


FiveExec 13-3, See Parser 


FixTempCnt 12-43] See Memory 

FlashToRam 12-44] See Memory 

ForceFullScreen 


14-1 


See Screen 

FormBase |l-16j See Display 

FormDCpIx |l-18j See Display 

FormEReal Il-20l See Display 

FormReal Il-21 1 See Display 

FourExec |13-5| See Parser 

FPAdd 

FPDiv 

FPMult 

FPRecip 

FPSquare 

FPSub 


10-60 


10-61 


10-62 


10-63 


10-64 


10-65 


See Math 
See Math 
See Math 
See Math 
See Math 
See Math 


TI-83 Plus Developer Guide 


R-7 


Third Release January 25, 2002 


Reference List - System Routines 


Frac 10-66 See Math 


Get_Tok_Strng 16-14, See Utility 


GetBaseVer |16-10| , See Utility 


GetCSC |8-3] See Keyboard 


GetKey |8-6,| See Keyboard 

GetLToOPI 1 9-7] See List 

GetMToOPI |1 1-3,| See Matrix 

GetTokLen |16-1 ij See Utility 


GrBufClr |5-31] See Graphing and Drawing 


GrBufCpy J5-32] See Graphing and Drawing 


GrphCirc 5-33 See Graphing and Drawing 


H 


PILTimes9 |l0-67j See Math 


PlorizCmd |5-34j See Graphing and Drawing 

PITimesL |10-68| See Math 


I 


Bounds |5-35j See Graphing and Drawing 


BoundsFull |5-36j See Graphing and Drawing 


Line |5-37] See Graphing and Drawing 

ncLstSize |9-8j See List 


nsertList 9-10 See List 


nsertMem 12-45] See Memory 


nt 10-69 See Math 


ntgr |10-70] See Math 


nvCmd 5-39, See Graphing and Drawing 


nvertFtect |5-40j See Graphing and Drawing 

nvOPIS MO-71 See Math 


nvOPISC 10-72 See Math 


nvOP2S 1 0-73, See Math 


nvSub |l0-74j See Math 

Offset |10-41 [ See Graphing and Drawing 


Point 10-42, See Graphing and Drawing 


sA2ByteTok 16-15 See Utility 


sEditEmpty |2-7| See Edit 

J 


JError 3-30. See Error 
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JErrorNo 

JForceCmdNoChar 

JForceGraphKey 

JForceGraphNoKey 

K 

KeyToString 


3-31 See Error 


16-16 

16-17 

16-18 


See Utility 
See Utility 
See Utility 


2-8 


See Edit 


LdHLInd 

LineCmd 

LnX 

Load_SFont 

LoadCIndPaged... 

LoadDEIndPaged 

LoadPattern 

LogX 


Il 2-471 See Memory 

5-44-1 See Graphing and Drawing 
10-751 See Math 


1-23 See Display 


12-47| See Memory 


12-49, See Memory 


1-22,1 See Display 


10-76 See Math 


M 


Max 


10-77 See Math 


MemChk |12-50] See Memory 

MemClear |l6-19j See Utility 

MemSet |16-20] See Utility 

Min |l 0-78 J See Math 


Minusl |1 0-79,1 See Math 

MovlOB 

Mov18B 

Mov7B 

Mov8B 

Mov9B 

Mov90P10P2 

Mov90P2Cp 

Mov9ToOP1 

Mov9ToOP2 

MovFrOPI 


16-21 

16-21 

16-21 

16-21 

16-21 


16-22 


16-23 


16-24 


16-25 


16-26 


See Utility 
See Utility 
See Utility 
See Utility 
See Utility 
See Utility 
See Utility 
See Utility 
See Utility 
See Utility 


N 


NewLine 


OneVar 


O 


1-24 See Display 


15-2 


See Statistics 
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OP1 ExOP2 

OP1 ExOP3 

OP1 ExOP4 

OP1 ExOP5 

OP1 ExOP6 

OP1 ExpToDec. 

OPISetO 

OPISetl 

OP1Set2 

OP1Set3 

OP1Set4 

OP1ToOP2 

OP1ToOP3 

OP1ToOP4 

OP1ToOP5 

OPIT0OP6 

OP2ExOP4 

OP2ExOP5 

OP2ExOP6 

OP2SetO 

OP2Set1 

OP2Set2 

OP2Set3 

OP2Set4 

OP2Set5 

OP2Set60 

OP2Set8 

OP2SetA 

OP2ToOP1 

OP2ToOP3 

OP2ToOP4 

OP2ToOP5 

OP2ToOP6 

OP3SetO 

OP3Set1 

OP3Set2 

OP3ToOP1 

OP3ToOP2 

OP3T0OP4 

OP3T0OP5 


16-28 

16-28 

16-28 

16-28 

16-28 


10-80 


10-81 

10-81 

10-81 

10-81 

10-81 


See Utility 
See Utility 
See Utility 
See Utility 
See Utility 
See Math 
See Math 
See Math 
See Math 
See Math 
See Math 


16-29 

See 

Uti 

ity 

16-29 

See 

Uti 

ity 

16-29 

See 

Uti 

ity 

16-29 

See 

Uti 

ity 

16-29 

See 

Uti 

ity 

16-28 

See 

Uti 

ity 

16-28 

See 

Uti 

ity 

16-28 

See 

Uti 

ity 


10-81 See Math 
10-81 See Math 
10-81 See Math 
10-81 See Math 
10-81 See Math 
10-81 See Math 
1 0-81 See Math 
)-82 See Math 
10-83,1 See Math 
16-29 See Utility 
16-29 See Utility 
16-29 See Utility 
16-29 See Utility 
16-29 See Utility 
10-81 See Math 
10-81 See Math 
10-81 See Math 
16-29 See Utility 
16-29 See Utility 
16-29 See Utility 
16-29 See Utility 
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OP4SetO 

OP4Set1 

OP4ToOP1 . 
OP4ToOP2. 
OP4ToOP3. 
OP4ToOP5. 
OP4ToOP6. 
OP5ExOP6. 


10-81 

10-81 


See Math 
See Math 


16-29 

16-29 

16-29 

16-29 

16-29 


16-28 


ty 

ty 

ty 

ty 

ty 

ty 


OP5SetO 10-81 

OP5ToOP1 

OP5ToOP2 

OP5T0OP3 

OP5ToOP4 

OP5ToOP6 

OP6T0OPI 

OP6T0OP2 

OP6T0OP5 


See Utili 
See Utili 
See Utili 
See Utili 
See Utili 
See Utili 
See Math 
See Utility 
See Utility 
See Utility 
See Utility 
See Utility 
See Utility 
See Utility 
See Utility 

OutputExpr |l-24[ See Display 


16-29 

16-29 

16-29 

16-29 

16-29 

16-29 

16-29 

16-29 


PagedGet.... 

Parselnp 

PDspGrph.... 

PixelTest 

Plusl 

PointCmd 

PointOn 

PopMCpIxOI 

PopOPI 

PopOP3 

PopOP5 

PopReal 

PopRealOl .. 
PopReal02.. 
PopReal03.. 
PopReal04.. 
PopReal05.. 
PopReal06.. 
PosNoOInt.... 
PtoR 


12-51 See Memory 


13-7 See Parser 


5-46, See Graphing and Drawing 


5-47, See Graphing and Drawing 


10-84 See Math 


4-11 


4-12 

4-12 

4-12 


5-48 See Graphing and Drawing 
5-50 J See Graphing and Drawing 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 


4-13 


4-14 

4-14 

4-14 

4-14 

4-14 

4-14 


16-30, See Utility 


10-85 See Math 
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PushMCpIxOI 

PushMCplx03 

PushOPI 

PushOP3 

PushOP5 

PushReal 

PushRealOl .. 
PushReal02 .. 
PushReal03 .. 
PushReal04 .. 
PushReal05 .. 
PushReal06 .. 

PutC 

PutMap 

PutPS 

Puts 

PutTokString... 

PutToL 

PutToMat 


Randlnit 

Random 

Rcl_StatVar 

RclAns 

RCIGDB2 

RcIN 

RcISysTok 

RcIVarSym 

RclX 

RclY 

Reel stByte 

RecIstByteNC 

RecABytelO 

RedimMat 

Regraph 

ReleaseBuffer 

ReloadAppEntryVecs 

RestoreDisp 

RName 


R 


4-15 

4-15 


4-16 

4-16 

4-16 


4-17 


4-18 

4-18 

4-18 

4-18 

4-18 

4-18 


See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 
See Floating Point Stack 


1-26, See Display 


1-27, See Display 


1-28J See Display 


1-32J See Display 


1-34J See Display 


11-4. 


9-12 See List 


See Matrix 


10-86 See Math 


10-87 See Math 


15-3, See Statistics 


16-33,1 See Utility 


12-52 See Memory 


12-53 See Memory 


13-9, See Parser 


12-56 


12-54] See Memory 
12-55] See Memory 
See Memory 
.{743] See 10 
.{74] See 10 
.f75]See 10 


12-57] See Memory 


5-51 , See Graphing and Drawing 
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RndGuard... 

RnFx 

Round 

RToD 

RToP 

RunlndicOff 


10-89 


10-90 


10-91 


10-92 


10-93 


See Math 
See Math 
See Math 
See Math 
See Math 
<36] See Display 


RunlndicOn 1-37, See Display 


SaveDisp |l-38,|See Display 

SendAByte 7-6, See 10 

SendVarCmd ]7-6,I See 10 

SetAIIPIots 

SetFuncM 


5-52, 


5-53, 


See Graphing and Drawing 
See Graphing and Drawing 

SetNorm Vals 1-39, See Display 

SetParM |5-54j See Graphing and Drawing 

SetPolM 5-55, See Graphing and Drawing 

SetSeqM |5-56j See Graphing and Drawing 

SetTbIGraphDraw |5-57j See Graphing and Drawing 

SetupPagedPtr |l2-58] See Memory 

SetXXOPI |1 6-37,| See Utility 

SetXXOP2 |1 6-38,| See Utility 

SetXXXXOP2 1 16-39] See Utility 

SFont_Len |l-40,| See Display 

Sin |1 0-94,| See Math 

SinCosRad 10-95, See Math 

SinH 10-96, See Math 

SinPICosPI 10-97, See Math 

SqRoot |1 0-98,| See Math 

SrchVLstDn, SrchVLstUp 1 12-59, See Memory 

SStringLength |1-41 ,| See Display 

StMatEI 12-60, See Memory 

StoAns 12-61 , See Memory 

StoGDB2 12-62, See Memory 

StoN 12-63, See Memory 

StoOther 12-64, See Memory 

StoR 12-66, See Memory 

StoRand 1 6-40, | See Utility 

StoSysTok |12-67,| See Memory 

StoT |1 2-68,| See Memory 
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StoTheta. 

StoX 

StoY 

StrCopy .. 
StrLength 


Tan 

TanH 

TanLnF 

TenX 

ThetaName 

ThreeExec. 

Times2 

TimesPt5 ... 

TName 

ToFrac 

Trunc 

TwoVarSet.. 


12-69, 

See Memory 
See Memory 

12-70, 

12-71, 

See Memory 


16-41, 

See Utility 
See Utility 


16-42, 


T 


10-99, 


10-100 


See Math 
See Math 


5-58, See Graphing and Drawing 


..10-101, 

See Math 

See Math 

See Parser 

See Math 

.. 10-102 

. 13-10, S 

o 

o 

GO 

..10-104, 

See Math 

..10-105, 

See Math 

..10-106, 

See Math 

..10-107, 

See Math 

15-4, See Statistics 


UCLineS 

UnLineCmd 

UnOPExec. 


VertCmd .... 
VPutMap.... 

VPutS 

VPutSN 

VtoWHLDE 


Xftol 

Xitof 

XName 

XFtootY 


Yftol 

YName 


U 


5-59, See Graphing and Drawing 


5-60, See Graphing and Drawing 


13-12, See Parser 


5-61 See Graphing and Drawing 
See Display 


1-42 


1-43,| See Display 


1-45,1 See Display 


5-62, See Graphing and Drawing 


5-63, See Graphing and Drawing 


5-64 See Graphing and Drawing 


10-108 See Math 


10-109, See Math 


5-65,1 See Graphing and Drawing 
10-110] See Math 
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YToX 


Zero'! 6D ... 

ZeroOP 

ZeroOPI ... 
ZeroOP2... 
ZeroOP3... 
ZmDecml .. 

ZmFit 

Zmlnt 

ZmPrev 

ZmSquare. 

ZmStats.... 

ZmTrig 

ZmUsr 

ZooDefault 


10 - 111 , 


Math 


Z 


5-66, 

5-67, 

5-68, 

5-69, 

5-70, 

5-71, 

5-72, 

5-73, 

5-74, 


See 

See 

See 

See 

See 

See 

See 

See 

See 


See Math 
See Math 
See Math 
See Math 
See Math 
Graphing and Drawing 
Graphing and Drawing 
Graphing and Drawing 
Graphing and Drawing 
Graphing and Drawing 
Graphing and Drawing 
Graphing and Drawing 
Graphing and Drawing 
Graphing and Drawing 


10 - 112 , 

10-113, 

10-114, 

10-114, 

10-114, 
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ACC 

Address 

APD™ 

API 

Applet 

Archive 

memory 

ASAP 

ASCII 

Assembler 

Assembly 

language 

Binary 


ACC stands for accumulator. 

A number given to a location in memory. You can access the location by 
using that number, like accessing a variable by using its name. 

Automatic Power Down™. 

Application Programmer’s Interface — the set of software services available 
to an application and the interface for using them. 

A stand-alone application, usually in Flash ROM, with the associated 
security mechanisms in place. See ASAP. 

Part of Flash ROM. You can store data, programs, or other variables to the 
user data archive, which cannot be edited or deleted inadvertently. 

Assembly Application Program — a RAM-resident application. 

American Standard Code for Information Interchange — a convention for 
encoding characters, numerals in a seven or eight-bit binary number. 

A program that converts source code into machine language that the 
processor can understand, similar to compilers used with high-level 
languages. 

A low-level language used to program microprocessors directly. Z80 
assembly language can be used on the TI-83 Plus to write programs that 
execute faster than programs written in TI-BASIC. See Chapter 3 for 
advantages and disadvantages. 

A system of counting using 0’s and 1’s. The first seven digits and the 
decimal equivalents are: 

0 0 

1 1 

10 2 

II 3 

100 4 

101 5 

110 6 

III 7 

See also Hexadecimal. 

Short for binary digit — either 1 or 0. In computer processing and storage, a 
bit is the smallest unit of information handled by a computer and is 
represented physically by an element such as a single pulse sent through a 
circuit or a small spot on a magnetic disk capable of storing either a 1 or a 0. 
Considered singly, bits convey little information a human would consider 
meaningful. In groups of eight, however, bits become the familiar bytes used 
to represent all types of information, including the letters of the alphabet and 
the digits 0 through 9. (Microsoft Encarta ‘97) 
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Boot (code) 

A small amount of software that resides in ROM; therefore, it cannot be 
overwritten or erased. Boot code is required for the calculator to manage the 
installation of new base code. 

Byte 

A unit of information consisting of 8 bits, the equivalent of a single character, 
such as a letter. 8 bits equal {0-255} and there are 256 letters in the 
extended ASCII character set. Standard ASCII uses a 7-bit value (0-127), 
thus there are 128 characters. 

Calculator 
serial number 

An electronic serial number that resides in a calculator’s Flash memory. It is 
used to uniquely identify that calculator. 

Character 

A single letter, digit, or symbol. Q is a character. 4 is a character. % is a 
character. 123 and yo are not characters. 

Compiled 

language 

Compiler 

D-Bus 

A language that must be compiled before you can run the program. 

Examples include C/C++ and Pascal. 

A compiler translates high-level language source code into machine code. 

A proprietary communication bus used between calculators, the 
Calculator-Based Laboratory™ (CBL™) System, the Calculator-Based 
Ranger™ (CBR™) and personal computers. 

Decimal 

The standard (base 10) system of counting, as opposed to binary (base 2) 
or hexadecimal (base 16). 

E-Bus 

Enhanced D-Bus. 

Entry points 

Callable locations in the base code corresponding to pieces of code that 
exhibit some coherent functionality. 

Execute 

To run a program or carry out a command. 

Flash-D 

A PC program that is the integration of a PC downloader application with a 
calculator application. When the Flash-D program is executed on the PC, 
the calculator application is transferred to the calculator via a 

TI-GRAPH LINK™ cable. 

Freeware 

Programs or databases that an individual may use without payment of 
money to the author. Commonly, the author will copyright the work as a way 
of legally insisting that no one change it prior to getting approval. Commonly, 
the author will issue a license defining the terms under which the 
copyrighted program may be used. With freeware, there is no charge for the 
license. 

Garbage 

collection 

A procedure that automatically determines what memory a program is no 
longer using and recycles it for other use. This is also known as automatic 
storage (or memory) reclamation. 

TItGRAPH 

LINK™ 

An optional accessory that links a calculator to a personal computer to 
enable communication. 

Group 

certificate 

Used to identify several calculators as a single unit. This allows the group of 
calculators, or unit, to be assigned a new program license using only one 
certificate (instead of requiring a new unique unit certificate for each 
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Hexadecimal 

High-level 

language 

IDE 

Immediate 

Interpreted 

language 


Instruction 

I/O port 

LCD port 

Low-level 

language 

Machine 

language 

Mac Link 
Marked Dirty 

Memory 

Microprocessor 

Operating 
System (OS) 


calculator in the group). The group certificate must be used in conjunction 
with the unit certificate. 

Base 16 system, which is often used in computing. Counting is as follows: 
{0,1 ,2,3,4,5,6,7,8,9,A,B,C,D,E,F}. 

Any programming language that resembles English. This makes it easier for 
humans to understand. Unfortunately, a computer cannot understand it 
unless it is compiled into machine language. See also low-level language. 
Examples of high-level languages are C/C++, Pascal, FORTRAN, COBOL, 
Ada, etc. 

Integrated Development Environment. 

An addressing mode where the data value is contained within the instruction 
instead of being loaded from somewhere else. For example, in LD A, 17, 17 
is an immediate value. In LD A, B, the value in B is not immediate, because 
it is not written into the code. 

A language that is changed from source code to machine language in real- 
time. Examples are BASIC (for the PC and the Tl version, TI-BASIC) and 
JavaScript. Interpreted languages are often much simpler, which helps 
beginners get started and allows experienced programmers to write code 
quickly. Interpreted languages, however, are restricted in their capability, 
and they run slower. 

A command that tells the processor to do something, for example, add two 

numbers or get some data from the memory. 

An input/output interface from the calculator to the external world. It allows 
communication with other units, CBL™ and CBR™, and personal computers. 

An output port that drives LCD display device for use on overhead 
projectors. Available on the teacher’s ViewScreen™ calculator only. 

Any programming language that does not look like English but is still to be 
understandable by people. It uses words like add to replace machine 
language instructions like 110100 . See also high-level language. 

Any programming language that consists of 1’s and 0’s (called binary), 
which represents instructions. A typical machine instruction could be 
1 1 01 00, which means add two numbers together. 

Macintosh resident link software that can communicate with the calculator. 

The graph is marked as needing to be updated. The next system routine 
that will affect the graph contents will cause the system to regraph all of the 
equations selected thereby making the graph clean. 

Memory is where data is stored. On the Tl— 83 Plus, the main memory is the 
built-in 32K of RAM. This memory is composed of one-byte sections, each 
with a unique address. 

See processor. 

The software included with every new calculator. OS contains the features 
that are of interest to customers, as well as behind-the-scenes functionality 
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Processor 

that allows the calculator to operate and communicate. In our newer 
calculators, the OS is in Flash ROM, so the user can electronically upgrade 
it with OS. 

A large computer chip that does most of the work in a computer or 
calculator. The processor in the TI-83 Plus is the Zilog Z80 chip. 

Program 

A program is a list of instructions written in sequential order for the 
processor to execute. 

Program ID 
number 

An ID number assigned to a particular software program. It is used during 
the program authentication process to match the program licenses in a 
unit/group certificate to the program being downloaded into the calculator. 

Program 

license 

A digital license purchased by a customer allowing the customer to authorize 
the download/execution of a particular software program to a specific 
calculator. The program licenses are assigned to and listed in the calculator 
unit/group certificates. 

Register 

A register is high-speed memory typically located directly on the processor. 

It is used to store data while the processor manipulates it. On the TI-83 Plus 
there are 14 registers. 

Register pair 

Two registers being used as if they were one, creating a 16-bit register. 
Larger numbers can be used in registered pairs than in single registers. The 
register pairs are AF, BC, DE, and HL. Register pairs are often used to hold 
addresses. 

Run (Busy) 
Indicator 

When the TI-83 Plus is calculating or graphing, a vertical moving line is 
displayed as a busy indicator in the top-right corner of the screen. When you 
pause a graph or a program, the busy indicator becomes a vertical moving 
dotted line. 

SDK 

Software Development Kit — a set of tools that allow developers to write 
software for specific platforms. 

Shareware 

Sometimes called User Supported or Try Before You Buy software. 
Shareware is not a particular kind of software, it is a way of marketing 
software. Users are permitted to try the software on their own computer 
systems (generally for a limited period of time) without any cost of obligation. 
Payment is required if the user has found the software to be useful or if the 
user wishes to continue using the software beyond the evaluation (trial) 
period. 

Payment of the registration fee to the author will bring the user a license to 
continue using the software. Most authors will include other materials in 
return for the registration fee — like printed manuals, technical support, 
bonus or additional software, or upgrades. 

Shareware is commercial software, fully protected by copyright laws. Like 
other business owners, shareware authors expect to earn money from 
making their software available. In addition, by paying, the user may then be 
entitled to additional functions, removal of time limiting or limits on use, 
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Signed 

application 

Silent link 

removal of so-called nag screens, and other things as defined in the 
documentation provided by the program’s author. 

An application that has been digitally signed by Tl. 

Computer-initiated request — protocol version of communications between 
the computer and the calculator. 

Software 

owner’s 

account 

An account set-up in the Tl database listing all of the program licenses 
owned by a particular customer or group. The account also allows the 
software owner to assign a particular program to a specific calculator. 

Source code 

A text file containing the code, usually in a high-level or low-level 
programming language. 

TASM 

Table Assembler — a PC program that assembles source code for the Z80 
and other processors. This has been one of the more popular tools for 
developing calculator ASM programs. 

TI-BASIC 

The programming language commonly used on the TI-83 Plus. It is the 
language that is used for PROGRAM variables. Its main drawback is that 
these programs run slower, since it is an interpreted language, rather than a 
compiled language. 

Tl signature 

A digital signature placed on secured documents/files such as unit and 
group certificates, as well as software program images. 

User Data 
Archive 

Storage for user data in the Flash ROM. In some cases, the user can 
choose between the amount of Flash for applets versus user data. 

Unique 
owner ID 

An alphanumeric ID assigned to the owner of a software owner’s account as 
a way of authorizing access to this account. Examples of the ID are mother’s 
maiden name, social security number, birth date, etc. 

Unit 

certificate 

A digital certificate signed by Tl that lists all of the program and group 
licenses issued to a specific calculator. The unit certificate also includes 
owner ID information and the calculator serial number. 

Z80 

This processor is used in the TI-83 Plus. Z80 assembler is the language 
used to program the Z80 chip. 

ZDS 

Zilog Development Studio — a tool used by developers to write software for 
Zilog products. This tool can be used to develop TI-83 Plus calculator 
applications and ASM programs. 
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